List Calls
Calls
List Calls
GET
List Calls
Retrieve a paginated list of calls for your organization.
Query Parameters
integer
default:"50"
Maximum number of calls to return (1-100).
string
Base64-encoded cursor from previous response for pagination. Omit for first page.
Response
boolean
Indicates if the request was successful.
array
List of call summary objects.
object
Pagination metadata.
next_cursor: Cursor for fetching next pagehas_more: Boolean indicating if more results existpage_size: Number of results in current page
Call Summary Fields
string
required
Unique call identifier (format:
call_ prefix + alphanumeric).string
required
Phone number that was called (E.164 format).
string
Caller phone number (E.164 format).
string
required
ID of the agent that handled the call.
string
Name of the agent.
string
Type of call:
inbound, outbound, or preview.string
Current call status (e.g.,
completed, ringing, in_progress).boolean
Whether recording was enabled for this call.
number
Total cost in credits.
number
Call duration in seconds.
number
Number of conversation turns.
string
ISO8601 timestamp when the call was created.
string
Reason why the call ended (e.g.,
tool_end_call, user_hangup).This endpoint uses cursor-based pagination. Use the
next_cursor from the response
to fetch subsequent pages. Omit the cursor parameter for the first page.