List Calls
Lists an agent’s calls, or the calls placed for one outbound call batch. One of agent_id or batch_id is required.
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-08-14 "2026-08-14"
Query Parameters
The ID of the agent. Required unless batch_id is supplied.
"agent_abc123"
The ID of the outbound call batch. Required unless agent_id is supplied. Returns one entry per call attempt, so a retried recipient appears more than once. Recipients that failed before dialing have no call record here and remain on Get Call Batch.
"acb_abc123"
Only return calls that started at or after this RFC 3339 timestamp, inclusive.
Only return calls that started at or before this RFC 3339 timestamp, inclusive.
The fields to expand in the response. Currently, the only supported value is transcript.
(Pagination option)The ID of the call to start after.
(Pagination option) The ID of the call to end before.
(Pagination option) The number of calls to return per page, ranging between 1 and 100.