API Reference

Submit one lead for calling

Accepted in milliseconds; the call is placed afterwards. A 202 means the lead is queued, NOT that a call connected — outcomes arrive separately.

The schema is CLOSED: a field we have not agreed is a 422, never a silently ignored extra. No income figure and no credit-bureau data is accepted at all.

Headers

X-Dhana-Client-IdstringRequired
Issued per environment. Sandbox and production credentials are different values.
X-Dhana-TimestampstringRequiredformat: "^\d{1,15}$"
Unix epoch SECONDS, UTC. Rejected beyond 300 seconds of our clock in either direction.
X-Dhana-NoncestringRequiredformat: "^[A-Za-z0-9_-]{16,64}$"

Unique per request, 16–64 characters of [A-Za-z0-9_-]. Remembered for 600 seconds; a repeat inside that window is rejected as a replay.

X-Dhana-SignaturestringRequiredformat: "^v1=[0-9a-f]{64}$"

v1=<lowercase hex HMAC-SHA256>. See the canonical string in the integration guide.

Idempotency-KeystringOptional<=200 characters

One value per logical lead, kept 72 hours. Resending the same key returns 200 with the original result instead of placing a second call. Strongly recommended: without it, a retried request after a network timeout can ring the borrower twice.

Request

This endpoint expects an object.
lead_idstringRequired1-120 characters
lead_created_atdatetimeRequired
campaign_codestringRequired1-80 characters
applicantobjectRequired
consentobjectRequired
employmentobjectOptional
loan_requestobjectOptional
application_stateobjectOptional
sourceobjectOptional
routingobjectOptional
metadatamap from strings to stringsOptional
experiment_armstringOptional1-40 characters

Response

Idempotent replay — this lead was already received. No second call is placed. Carries x-dhana-idempotent-replay: true.

lead_idstring
statusenum

Errors

401
Unauthorized Error
422
Unprocessable Entity Error