List 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>",
      "status": "active",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "transcript": [
        {
          "role": "<string>",
          "start_timestamp": 123,
          "end_timestamp": 123,
          "text": "<string>",
          "text_chunks": [
            {
              "text": "<string>",
              "start_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>",
      "error_message": "<string>",
      "deployment_id": "<string>"
    }
  ],
  "next_page": "<string>"
}

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>",
      "status": "active",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "transcript": [
        {
          "role": "<string>",
          "start_timestamp": 123,
          "end_timestamp": 123,
          "text": "<string>",
          "text_chunks": [
            {
              "text": "<string>",
              "start_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>",
      "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.

Show child attributes

data.id

string

required

The unique identifier for the agent call.

data.agent_id

string

required

The identifier of the agent associated with the call.

data.status

enum<string>

required

The status of the agent call.

Available options:

active,

completed,

failed,

cancelled

data.start_time

string<date-time> | null

The start time of the agent call.

data.end_time

string<date-time> | null

The end time of the agent call.

data.transcript

AgentTranscript · object[] | null

The transcript of the agent call.

Show child attributes

data.transcript.role

string

required

The role of the participant in the conversation. Roles are user, assistant, or system. assistant is the agent. system is used to indicate logs during the conversation such as log_event or log_metric.

data.transcript.start_timestamp

number<float>

required

The start timestamp in seconds relative to the start of the call.

data.transcript.end_timestamp

number<float>

required

The end timestamp in seconds relative to the start of the call.

data.transcript.text

string | null

The text content of the transcript. This is the text that was spoken by the user or the agent.

data.transcript.text_chunks

TextChunk · object[] | null

The chunks of text at a more granular level in the transcript with timestamps relative to the start of the call.

Show child attributes

data.transcript.text_chunks.text

string

required

The text content of the chunk.

data.transcript.text_chunks.start_timestamp

number<double>

required

The starting timestamp of the text chunk in seconds relative to the start of the call.

data.transcript.end_reason

string | null

The reason for why the assistant turn ended. This could be call_ended, interrupted, or tts_completed.

data.transcript.tool_calls

ToolCall · object[] | null

The tool calls made during the turn.

Show child attributes

data.transcript.tool_calls.id

string

required

The unique identifier for the tool call.

data.transcript.tool_calls.name

string

required

The name of the tool that was called.

data.transcript.tool_calls.arguments

object

required

The arguments passed to the tool.

Show child attributes

data.transcript.tool_calls.arguments.{key}

string

data.transcript.vad_buffer_ms

integer | null

The VAD buffer time in milliseconds.

data.transcript.tts_ttfb

number<float> | null

The time to first byte in seconds from the agent for text-to-speech.

data.transcript.log_event

LogEvent · object

The log event from user code.

Show child attributes

data.transcript.log_event.event

string

required

The event name.

data.transcript.log_event.metadata

object

required

Additional metadata associated with the event.

Show child attributes

data.transcript.log_event.metadata.{key}

string

data.transcript.log_event.timestamp

number<double>

required

The timestamp when the event was received relative to the start of the call.

data.transcript.log_metric

LogMetric · object

The log metric from user code.

Show child attributes

data.transcript.log_metric.name

string

required

The name of the metric.

data.transcript.log_metric.value

number<double>

required

The value of the metric.

data.transcript.log_metric.timestamp

number<double>

required

The timestamp when the metric was received relative to the start of the call.

data.telephony_params

TelephonyParams · object

The telephony parameters associated with the call when the call is made via phone.

Show child attributes

data.telephony_params.to

string

required

The phone number of the caller.

data.telephony_params.from

string

required

The phone number of the agent.

data.summary

string | null

A summary of the agent call. This is a brief summary of the call that is generated by Cartesia.

data.error_message

string | null

The error message, if any, associated with the call.

data.deployment_id

string | null

The deployment identifier associated with the call.

next_page

string | null

The cursor for the next page of results.

List Phone Numbers

Get Call

⌘I

Use the API

API Status

TTS

STT

Agents

Voices

Voice Changer

Auth

Datasets

Fine Tunes

Infill

Pronunciation Dicts

Authorizations

Headers

Query Parameters

Response