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 Rachel 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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt

Use this file to discover all available pages before exploring further.

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)

​
status
enum<string>

Filter by call telephony outcome. Targets the call_status column.

Available options:
completed,
no-answer,
failed,
busy,
dispatch_timeout
​
campaign_id
string<uuid>

Filter by campaign id.

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)