Skip to main content
GET

Request

Retrieve a paginated list of calls for your account with optional filtering.

Headers

string
required
Bearer token for authentication. Format: Bearer YOUR_API_KEY

Query Parameters

integer
default:"20"
Number of calls to return (1-100)
string
Pagination cursor from a previous response
string
Filter by status: queued, ringing, in_progress, completed, failed, no_answer, busy
string
Filter by agent ID
string
Filter by destination phone number
string
Filter calls created after this ISO 8601 date
string
Filter calls created before this ISO 8601 date
string
default:"desc"
Sort order: asc or desc (by created_at)

Response

array
Array of call objects
boolean
Whether there are more results available
string
Cursor to use for fetching the next page
integer
Total number of calls matching the filter

Pagination

Use cursor-based pagination for efficient traversal of large result sets:

Error Codes