Skip to main content
GET
/
agents
/
calls
List Calls
curl --request GET \
  --url https://api.cartesia.ai/agents/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'
{
  "data": [
    {
      "id": "<string>",
      "agent_id": "<string>",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "transcript": [
        {
          "role": "<string>",
          "text": "<string>",
          "text_chunks": [
            {
              "text": "<string>",
              "start_timestamp": 123
            }
          ],
          "start_timestamp": 123,
          "end_timestamp": 123,
          "end_reason": "<string>",
          "tool_calls": [
            {
              "id": "<string>",
              "name": "<string>",
              "arguments": {}
            }
          ],
          "vad_buffer_ms": 123,
          "tts_ttfb": 123,
          "log_event": {
            "event": "<string>",
            "metadata": {},
            "timestamp": 123
          },
          "log_metric": {
            "name": "<string>",
            "value": 123,
            "timestamp": 123
          }
        }
      ],
      "telephony_params": {
        "to": "<string>",
        "from": "<string>"
      },
      "summary": "<string>",
      "status": "active",
      "error_message": "<string>",
      "deployment_id": "<string>"
    }
  ],
  "next_page": "<string>"
}

Authorizations

Authorization
string
header
required

Cartesia API key

Headers

Cartesia-Version
enum<string>
required

API version header. Must be set to the API version, e.g. '2024-06-10'.

Available options:
2024-06-10,
2024-11-13,
2025-04-16
Example:

"2025-04-16"

Query Parameters

agent_id
string
required

The ID of the agent.

expand
string | null

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

starting_after
string | null

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

ending_before
string | null

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

limit
integer | null

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

Response

200 - application/json
data
AgentCall · object[]
required

The list of agent calls.

next_page
string | null

The cursor for the next page of results.