AgentsCalls

List Calls

Lists calls sorted by start time in descending order for a specific agent. agent_id is required and if you want to include transcript in the response, add expand=transcript to the request. This endpoint is paginated.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Cartesia-Version"2025-04-16"Required

Query parameters

agent_idstringRequired
The ID of the agent.
expandstringOptional

The fields to expand in the response. Currently, the only supported value is transcript.

starting_afterstringOptional

(Pagination option)The ID of the call to start after.

ending_beforestringOptional

(Pagination option) The ID of the call to end before.

limitintegerOptionalDefaults to 10

(Pagination option) The number of calls to return per page, ranging between 1 and 100.

Response

This endpoint returns an object.
datalist of objects
The list of agent calls.
next_pagestring or null
The cursor for the next page of results.