A contact's best time to call
The estimated chance a human answers in each local hour, built from the
contact's own answered/attempted counts, backed off to its number prefix and
to the campaign-wide curve. Available on every campaign, whatever its
retry.ordering.
Authorization
bearerAuth Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the
platform keyring. Carries workspace_id and scopes claims;
revoked via the platform deny-list.
In: header
Path Parameters
uuiduuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/dialer/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08/best-time"{ "hours": [ { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 }, { "hour": 0, "score": 0 } ], "best_hour": 0, "evidence": "contact", "attempts": 0, "timezone": "string"}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}Update or cancel a contact PATCH
Changes only the fields sent; an empty `callback_url` or `timezone` clears it. `status: "canceled"` withdraws a queued, waiting_retry or callback contact (409 for any other state).
List a campaign's call attempts GET
The per-contact attempt log: times, outcome, call id and costs. Newest first.