API Reference

Read call outcomes

One row per ATTEMPT, not per lead — a lead retried three times has three rows, distinguished by attemptNumber.

Signed exactly like POST /v1/leads, except that the canonical string covers the path WITHOUT its query string.

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.

Query parameters

fromdatetimeOptional
RFC 3339. Filters on lead creation time, inclusive.
todatetimeOptional
RFC 3339, exclusive.
campaignCodestringOptional
limitintegerOptional>=1

Clamped to a maximum server-side.

offsetintegerOptional>=0

Response

A page of attempts.
callslist of objects
pageobject
noticestringOptional

Present when any row was relabelled. Show it wherever the outcomes are shown — it explains a correction we make to the telephony provider’s own reporting.

Errors

401
Unauthorized Error
422
Unprocessable Entity Error