Skip to main content
GET
/
v1
/
calls
List calls
curl --request GET \
  --url https://api.topcalls.ai/v1/calls \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "564d4fd4-03bc-400a-abe0-05540fbeff88",
      "created_at": "2025-12-22T10:30:00Z",
      "phone_number": "+14155551234",
      "from_phone_number": "+18005551234",
      "status": "completed",
      "call_status": "completed",
      "duration": 2.5,
      "started_at": "2025-12-22T10:30:05Z",
      "end_at": "2025-12-22T10:32:35Z",
      "campaign_id": null,
      "lead_id": null,
      "answered_by": "human",
      "error_message": null,
      "recording_url": "https://api.example.com/recordings/2025/12/22/mp3",
      "transcript": [
        {
          "id": 1,
          "user": "assistant",
          "text": "Hi, this is Sarah from TopView Dental...",
          "created_at": "2025-12-22T10:30:05Z"
        }
      ],
      "call_summary": "Successfully confirmed appointment...",
      "disposition": "confirmed",
      "actual_duration_billed": 2.5
    }
  ],
  "next_cursor": "2025-12-22T10:29:00Z"
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Query Parameters

limit
integer
default:50

Maximum number of results (1-200)

Required range: 1 <= x <= 200
cursor
string<date-time>

Pagination cursor (ISO 8601 timestamp)

Response

List of calls

data
object[]

Array of call objects with essential fields only

next_cursor
string<date-time> | null

Pagination cursor for next page (ISO 8601 timestamp)