Skip to main content
GET
List calls

Authorizations

Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Query Parameters

limit
integer
default:50

Maximum number of results (1-200)

Required range: 1 <= x <= 200
cursor
string<date-time>

Pagination cursor (ISO 8601 timestamp)

status
enum<string>

Filter by call telephony outcome. Targets the call_status column.

Available options:
completed,
no-answer,
failed,
busy,
dispatch_timeout
campaign_id
string<uuid>

Filter by campaign id.

phone_number
string

Filter by destination phone number (exact match, E.164 format).

from_phone_number
string

Filter by caller ID used (exact match, E.164 format).

answered_by
enum<string>

Filter by who answered the call.

Available options:
human,
voicemail,
ivr,
unknown
disposition
string

Filter by call disposition/outcome (exact match, e.g. "confirmed", "interested", "no_answer").

lead_id
string<uuid>

Filter by lead id.

created_after
string<date-time>

Only return calls created at or after this timestamp.

created_before
string<date-time>

Only return calls created at or before this timestamp.

Response

List of calls

data
object[]

Array of call objects with essential fields only

next_cursor
string<date-time> | null

Pagination cursor for next page (ISO 8601 timestamp)