List Calls
List voice and video calls, newest first, with status, duration and cost.
The window defaults to the last 30 days. Filter by agent_id, by type to
separate web calls from phone calls, by contact_key for one customer’s
whole history, or by batch_id for every call one outbound batch placed.
Text conversations are not calls — those live under list_conversations.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
1 <= x <= 200x >= 0window start (default: 30d ago)
window end (default: now)
how the call reached the agent
WEB, SIP_INBOUND, SIP_OUTBOUND queued, in_progress, completed, failed or canceled
success, failure or unknown — whether the call achieved its purpose, as judged by post-call analysis
your stable id for the person on the call — every call with that one customer, however many numbers they rang from
exactly how the call ended, e.g. participant_disconnected, transferred, sip_user_unavailable_failed — the same strings the observability endings breakdown ranks
only calls placed by this outbound batch, retries included