Skip to main content
GET
List calls

Authorizations

Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Query Parameters

organization_id
string<uuid>

Organization UUID. Required when the request is authenticated with the internal server API key; ignored for organization API keys.

page
integer
default:1

Page number (1-based). Default 1.

Required range: x >= 1
page_size
integer
default:20

Page size. Default 20, maximum 100.

Required range: 1 <= x <= 100
agent_ids
string

Comma-separated agent UUIDs to restrict results.

status
enum<string>

Call lifecycle status.

Available options:
connected,
started,
in_progress,
auth_failed,
ended
source
enum<string>

How the call entered the platform.

Available options:
twilio,
sip,
simulation,
api
date_from
string

Filter calls with created_at on or after this instant (RFC3339 or ISO8601 string accepted by the backend).

date_to
string

Filter calls with created_at on or before this instant.

outbound
enum<string>
Available options:
true,
false

Substring match on party number (max 256 characters).

tag
string

Filter by tag (max 128 characters).

outcome
enum<string>

Filter by termination outcome / reason bucket.

Available options:
transferred,
agent_end,
user_end

Response

Paginated calls

calls
object[]
required
pagination
object
required