GET
List Calls

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:200
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0
start
string<date-time> | null

window start (default: 30d ago)

end
string<date-time> | null

window end (default: now)

agent_id
string<uuid> | null
type
enum<string> | null

how the call reached the agent

Available options:
WEB,
SIP_INBOUND,
SIP_OUTBOUND
status
string | null

queued, in_progress, completed, failed or canceled

outcome
string | null

success, failure or unknown — whether the call achieved its purpose, as judged by post-call analysis

contact_key
string | null

your stable id for the person on the call — every call with that one customer, however many numbers they rang from

close_reason
string | null

exactly how the call ended, e.g. participant_disconnected, transferred, sip_user_unavailable_failed — the same strings the observability endings breakdown ranks

batch_id
string<uuid> | null

only calls placed by this outbound batch, retries included

Response

Successful Response

has_more
boolean
required
items
CallSummaryResponse · object[]
required
limit
integer
required
offset
integer
required