GET
/
api
/
v1
/
calls
/
sid
/
{call_sid}
{
  "call_sid": "<string>",
  "to_phone_number": "<string>",
  "customer_phone_number": "<string>",
  "call_meta": {},
  "id": 123,
  "assistant_id": 123,
  "status": "<string>",
  "duration": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z"
}
This endpoint retrieves a single call record by its unique Twilio Call SID. This is useful when you have the SID from Twilio’s webhooks or logs and need to look up the corresponding call in your system.

​
Path Parameters

  • call_sid (string, required): The unique Call SID from Twilio.

​
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,
  "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,
  "cost": 0.05,
  "metadata": {
    "customer_id": "cust_abc123"
  },
  "created_at": "2023-10-30T10:00:00Z",
  "updated_at": "2023-10-30T10:05:00Z"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
call_sid
string
required

Response

200
application/json

Successful Response

Schema for call response.