Skip to main content
PATCH
/
lead
/
{lead_id}
/
status
Update lead status
curl --request PATCH \
  --url https://{tenant}.techea.eu/api/v1/lead/{lead_id}/status \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "event": "loan_issued",
  "advertiser_ref": "ADV-98765",
  "metadata": {
    "amount_issued": 8000,
    "term_months": 24
  }
}
'
{
  "lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "event": "registration",
  "status": "received"
}
The lead_id is assigned by TECHEA at submission time and must be passed through your integration from the moment you receive the lead.

​
Event types

EventWhen to send
registrationCustomer completed registration
loan_issuedLoan approved and disbursed
loan_rejectedCustomer rejected after evaluation
loan_paidLoan fully repaid
loan_defaultedCustomer defaulted

​
Publisher notification

When TECHEA receives a status update, it forwards the event to the publisher’s configured callback URL: 
GET {publisher_callback_url}?lead_id={lead_id}&event={event}
If your platform uses pixel-style callbacks (GET requests without a body), use the GET variant instead.

Authorizations

​
apikey
string
header
required

API Key provided by TECHEA

Path Parameters

​
lead_id
string<uuid>
required

Lead ID provided by TECHEA at submission time

Body

application/json
​
event
enum<string>
required

Event type reported by the advertiser:

  • registration: customer registered with the advertiser
  • loan_issued: loan was approved and issued
  • loan_rejected: advertiser rejected the customer
  • loan_paid: loan fully repaid
  • loan_defaulted: customer defaulted on the loan
Available options:
registration,
loan_issued,
loan_rejected,
loan_paid,
loan_defaulted
​
advertiser_ref
string

Advertiser's internal reference for this lead

​
metadata
object

Additional event data (amount issued, term, etc.)

Response

Status update received and processed

​
lead_id
string<uuid>
​
event
enum<string>

Event type reported by the advertiser:

  • registration: customer registered with the advertiser
  • loan_issued: loan was approved and issued
  • loan_rejected: advertiser rejected the customer
  • loan_paid: loan fully repaid
  • loan_defaulted: customer defaulted on the loan
Available options:
registration,
loan_issued,
loan_rejected,
loan_paid,
loan_defaulted
​
status
enum<string>
  • received: status update recorded and publisher notification triggered
  • ignored: update received but already processed (duplicate)
Available options:
received,
ignored