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

APIhttps://<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"
  }
}