List Calls
Retrieve all voice calls for the authenticated user.
GET
/v2/callsList all voice calls with pagination and filters.
Query Parameters
Max results (1-200)
Pagination offset
Filter: active, ended, error
Filter by agent public ID
Filter: web, inbound, outbound
ISO 8601 start date
ISO 8601 end date
Response 200
{
"calls": [
{
"id": 77,
"type": "web",
"status": "ended",
"agent_id": "ag_5d2678fd_e556",
"agent_name": "Priya Support Agent",
"started_at": "2026-03-25T10:20:57Z",
"ended_at": "2026-03-25T10:22:36Z",
"duration_seconds": 99.1,
"latency_ms": 475,
"cost": {
"total_usd": 0.08,
"total_inr": 6.80
}
}
],
"total": 42
}Response Fields
| Field | Type | Description |
|---|---|---|
calls | array | List of call objects |
calls[].id | integer | Call ID |
calls[].type | string | web, inbound, or outbound |
calls[].status | string | active, ended, error, pending |
calls[].agent_id | string | Agent public ID (ag_*) |
calls[].agent_name | string | Agent display name |
calls[].duration_seconds | float | Call duration in seconds |
calls[].latency_ms | integer | Average turn-around latency |
calls[].cost.total_inr | float | Total cost in INR |
total | integer | Total matching calls |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |