Skip to main content
GET
List calls

Authorizations

Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Query Parameters

limit
integer
default:50

Calls per page.

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

The next_cursor from the previous page. Returns calls created before it.

status
enum<string>

Filter by telephony outcome (call_status).

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

Filter by campaign id.

phone_number
string

Filter by the number called, exact E.164 match.

from_phone_number
string

Filter by the caller ID used, exact E.164 match.

answered_by
enum<string>

Filter by who answered the call.

Available options:
human,
voicemail,
ivr,
unknown
direction
enum<string>

outbound for calls we placed, inbound for calls received on your numbers.

Available options:
outbound,
inbound
disposition
string

Filter by disposition, exact match (for example confirmed).

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[]

Calls, newest first.

next_cursor
string<date-time> | null

Pass as cursor for the next page. Null when this page came back with fewer calls than limit.