Skip to main content
GET
/
api
/
calls
List Calls
curl --request GET \
  --url https://api.example.com/api/calls
{
  "success": true,
  "data": [
    {
      "call_sid": "call_abc123def456",
      "to_number": "+15559876543",
      "from_number": "+15551234567",
      "agent_id": "agent_xyz789",
      "agent_name": "Sales Rep",
      "client_id": "org_123",
      "call_type": "outbound",
      "status": "completed",
      "recording_enabled": true,
      "total_cost": 12.35,
      "duration_seconds": 120.5,
      "turn_count": 7,
      "created_at": "2026-03-09T10:00:00Z",
      "updated_at": "2026-03-09T10:02:30Z",
      "start_time": "2026-03-09T10:00:05Z",
      "end_time": "2026-03-09T10:02:25Z",
      "end_reason": "tool_end_call",
      "billing_status": "billed"
    }
  ],
  "pagination": {
    "next_cursor": "eyJjYWxsX3NpZCI6ICJjYWxsX2FiYzEyMyJ9",
    "has_more": true,
    "page_size": 50
  }
}
Retrieve a paginated list of calls for your organization.

Query Parameters

limit
integer
default:"50"
Maximum number of calls to return (1-100).
cursor
string
Base64-encoded cursor from previous response for pagination. Omit for first page.

Response

success
boolean
Indicates if the request was successful.
data
array
List of call summary objects.
pagination
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

call_sid
string
required
Unique call identifier (format: call_ prefix + alphanumeric).
to_number
string
required
Phone number that was called (E.164 format).
from_number
string
Caller phone number (E.164 format).
agent_id
string
required
ID of the agent that handled the call.
agent_name
string
Name of the agent.
call_type
string
Type of call: inbound, outbound, or preview.
status
string
Current call status (e.g., completed, ringing, in_progress).
recording_enabled
boolean
Whether recording was enabled for this call.
total_cost
number
Total cost in credits.
duration_seconds
number
Call duration in seconds.
turn_count
number
Number of conversation turns.
created_at
string
ISO8601 timestamp when the call was created.
end_reason
string
Reason why the call ended (e.g., tool_end_call, user_hangup).
{
  "success": true,
  "data": [
    {
      "call_sid": "call_abc123def456",
      "to_number": "+15559876543",
      "from_number": "+15551234567",
      "agent_id": "agent_xyz789",
      "agent_name": "Sales Rep",
      "client_id": "org_123",
      "call_type": "outbound",
      "status": "completed",
      "recording_enabled": true,
      "total_cost": 12.35,
      "duration_seconds": 120.5,
      "turn_count": 7,
      "created_at": "2026-03-09T10:00:00Z",
      "updated_at": "2026-03-09T10:02:30Z",
      "start_time": "2026-03-09T10:00:05Z",
      "end_time": "2026-03-09T10:02:25Z",
      "end_reason": "tool_end_call",
      "billing_status": "billed"
    }
  ],
  "pagination": {
    "next_cursor": "eyJjYWxsX3NpZCI6ICJjYWxsX2FiYzEyMyJ9",
    "has_more": true,
    "page_size": 50
  }
}
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.