Skip to main content
GET
/
agents
/
calls
/
{call_id}
Get Call
curl --request GET \
  --url https://api.cartesia.ai/agents/calls/{call_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'
{
  "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>"
}

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"

Path Parameters

call_id
string
required

The ID of the call.

Response

200 - application/json
id
string
required

The unique identifier for the agent call.

agent_id
string
required

The identifier of the agent associated with the call.

status
enum<string>
required

The status of the agent call.

Available options:
active,
completed,
failed,
cancelled
start_time
string<date-time> | null

The start time of the agent call.

end_time
string<date-time> | null

The end time of the agent call.

transcript
AgentTranscript · object[] | null

The transcript of the agent call.

telephony_params
object

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

summary
string | null

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

error_message
string | null

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

deployment_id
string | null

The deployment identifier associated with the call.