Skip to main content
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 page
  • has_more: Boolean indicating if more results exist
  • page_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.