Get a scheduled call
Returns one scheduled call, including the number it will dial and its state.
Scopes: call:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Path Parameters
Response
Successful Response
The scheduled call's id.
The agent that makes the call.
The callee's IANA time zone.
manual (booked through the API or dashboard), callback (a caller asked) or retry.
manual, callback, retry proposed (a callback waiting for confirmation; never dials on its own), scheduled, dialing, done, canceled or failed.
proposed, scheduled, dialing, done, canceled, failed Dial attempts made.
The number to call, masked.
When it dials (ISO 8601).
Why it was booked.
Values for the agent's {{variables}}.
The call that asked for it, for a callback.
The call it placed, once dialled.
The number it calls from.
Why the last attempt failed.
Who booked it.
When it was booked (ISO 8601).
When it last changed (ISO 8601).
The number to call, unmasked (single reads and writes only).