Get Call by ID

{
  "call_sid": "<string>",
  "to_phone_number": "<string>",
  "customer_phone_number": "<string>",
  "id": 123,
  "assistant_id": 123,
  "status": "<string>",
  "call_meta": {},
  "assistant_name": "<string>",
  "flow_name": "<string>",
  "duration": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "total_cost": 123,
  "llm_cost": 123,
  "tts_cost": 123,
  "stt_cost": 123,
  "telephony_cost": 123,
  "cost_currency": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

api

calls

{call_id}

{
  "call_sid": "<string>",
  "to_phone_number": "<string>",
  "customer_phone_number": "<string>",
  "id": 123,
  "assistant_id": 123,
  "status": "<string>",
  "call_meta": {},
  "assistant_name": "<string>",
  "flow_name": "<string>",
  "duration": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "total_cost": 123,
  "llm_cost": 123,
  "tts_cost": 123,
  "stt_cost": 123,
  "telephony_cost": 123,
  "cost_currency": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

This endpoint retrieves a single call record by its unique database ID.

Path Parameters

call_id (integer, required): The unique identifier for the call you want to retrieve.

Response

The response is a JSON object containing the full details of the specified call. The structure is the same as the objects returned by the List Calls endpoint.

Response

{
  "id": 101,
  "call_sid": "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "assistant_id": 123,
  "assistant_name": "ServiceBot",
  "flow_name": "Customer Support Flow",
  "to_phone_number": "+15551234567",
  "customer_phone_number": "+15559876543",
  "status": "completed",
  "started_at": "2023-10-30T10:00:00Z",
  "ended_at": "2023-10-30T10:05:00Z",
  "duration": 300,
  "call_meta": {
    "customer_id": "cust_abc123"
  },
  "total_cost": 0.05,
  "llm_cost": 0.02,
  "tts_cost": 0.01,
  "stt_cost": 0.01,
  "telephony_cost": 0.01,
  "cost_currency": "USD"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

call_id

integer

required

Response

Successful Response

Schema for call response.

call_sid

string

required

to_phone_number

string

required

customer_phone_number

string

required

integer

required

assistant_id

integer

required

status

string

required

call_meta

Call Meta · object | null

assistant_name

string | null

flow_name

string | null

duration

integer | null

started_at

string<date-time> | null

ended_at

string<date-time> | null

total_cost

number | null

llm_cost

number | null

tts_cost

number | null

stt_cost

number | null

telephony_cost

number | null

cost_currency

string | null

API Documentation

Assistants

Assistant Phone Numbers

Assistant Documents (RAG)

Voice Cloning

Calls

Messaging

SIP Trunks

Billing

Phone Number Management

Call Data

Organization

Webhooks & System

Campaigns

WebSockets

Tools & Custom Actions

Conversation Flows

Learning & Memory

Path Parameters

Response

Authorizations

Path Parameters

Response

​Path Parameters

​Response

Authorizations

Path Parameters

Response

Path Parameters

Response