Sender · Referral - Type A
Pre-check API
A Pre-check API allows a sender to check whether Konduit accepts a lead before sending the full lead payload.
This is a lightweight yes/no check based on the consumer's email address. The sender submits an email, and Konduit responds with whether the sender should proceed with submission of the full lead.
The pre-check is intended to reduce unnecessary full lead submissions when the email has already been seen in Type A flows globally.
Request
| API | https://<example.domain>/precheck |
|---|
Body
{
"email": "customer@example.com",
"referralCode": "test",
"loanPurpose": "PP",
"leadFlow": "OFFLINE"
}
Response
Proceed with the full lead submission only when the decision is ACCEPT.
ACCEPT Lead accepted
Response
{
"decision": "ACCEPT",
"message": "Lead can be submitted."
}
REJECT Lead not accepted
Response
{
"decision": "REJECT",
"message": "Duplicate lead, falls within the window of 100 days"
}
BAD_REQUEST Bad request
Response
{
"error": {
"code": "BAD_REQUEST",
"message": "email is required"
}
}