Skip to main content
GET
List Agent Sessions

Authorizations

Authorization
string
header
required

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

Query Parameters

agent_id
string | null
status
string | null

Comma-separated status filter (pending/active/completed/failed/unknown). Default: every status except pending.

caller_number
string | null

Exact-match caller E.164 (phone sessions only).

created_after
string | null
created_before
string | null
cursor
string | null
page
integer | null

1-based page number (offset pagination). Returns total; mutually exclusive with cursor, which deep scans must use.

Required range: x >= 1
include_total
boolean
default:false

Also count the filtered set on the cursor path.

page_size
integer
default:30
Required range: 1 <= x <= 100

Response

Request fulfilled, document follows

sessions
AgentSessionSummary · object[]
required
has_more
boolean
required
next_cursor
string | null
total
integer | null