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"
}Retrieve a paginated list of calls for your account.
Returns call details including transcript, recording URL, summary, and billing information.
For complete metadata and call configuration, use GET /v1/calls/{call_id}.
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"
}Use Authorization: Bearer tc_live_xxxxx
Maximum number of results (1-200)
1 <= x <= 200Pagination cursor (ISO 8601 timestamp)