Skip to main content
GET
/
agents
/
calls
/
batches
List Call Batches
curl --request GET \
  --url https://api.cartesia.ai/agents/calls/batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "agent_id": "<string>",
      "from_number_id": "<string>",
      "target_concurrency_limit": 123,
      "status": "<string>",
      "total_calls_scheduled": 123,
      "total_calls_dispatched": 123,
      "total_calls_finished": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "last_updated_at": "2023-11-07T05:31:56Z",
      "scheduled_at": "2023-11-07T05:31:56Z",
      "recipients": [
        {
          "id": "<string>",
          "to_number": "<string>",
          "status": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "agent_call_id": "<string>",
          "error_message": "<string>",
          "metadata": {}
        }
      ]
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

Authorizations

Authorization
string
header
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Query Parameters

agent_id
string | null

Filter to batches for this agent.

starting_after
string | null

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

ending_before
string | null

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

limit
integer | null

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

Response

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

The list of batches, newest first.

has_more
boolean
required

Whether there are more results available.

next_page
string | null

An ID that can be passed as starting_after or ending_before to get the next page of batches.