GET/api/v1/calls
Calls
List Calls
Returns paginated call summaries with assistant name, phone number, duration, activity state, recording URL, and timestamps.
Request
Endpoint
GET
/api/v1/callsAuthentication
x-api-keyorAuthorization: BearerQuery Parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number. Values below 1 are clamped to 1. |
limit | integer | Maximum items to return. Defaults to 20 and is capped at 100. Passing 0 is clamped to 1. |
Response Example
response.json
{
"success": true,
"data": [
{
"id": "665f1a2b3c4d5e6f7a8b9c0d",
"assistant": {
"id": "66aa2b3c4d5e6f7a8b9c0d11",
"name": "Sales Bot"
},
"call_type": "phone",
"direction": "outbound",
"phone_number": "+919876543210",
"call_duration": "00:01:23",
"active": false,
"is_demo_call": false,
"recording_url": "https://recordings.example.com/call.wav",
"created_at": "2026-05-01T10:00:00.000Z",
"call_end_time": "2026-05-01T10:01:23.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}Status Codes
| HTTP | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 401 | Unauthorized | Missing, invalid, inactive, or origin-restricted API key. |
| 429 | Rate limited | Per-IP or per-key request budget was exceeded. |
Security Model
User-scoped by default
This endpoint only sees resources owned by the user attached to the API key. If another user's id is supplied, the API responds as if the resource does not exist.