v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-014589156.1 KB
Phones

List sessions

Returns one page of the org's phone sessions for the Session Inspector table: active/unbilled sessions pinned on top, terminal history paginated beneath. Covers workflow runs and workflow-less interactive leases; each row links to a session. Filters: search, workflow_id, status.

get/phones/sessions

Query parameters

limitinteger

max rows to return (default 50, max 100)

max rows to return (default 50, max 100)

offsetinteger

rows to skip for pagination

rows to skip for pagination

searchstring

case-insensitive match on phone/session/workflow

case-insensitive match on phone/session/workflow

workflow_idstring

only sessions for this workflow

only sessions for this workflow

statusstring[] nullable

filter by session status (ACTIVE/COMPLETED/CANCELLED/EXPIRED); repeatable

filter by session status (ACTIVE/COMPLETED/CANCELLED/EXPIRED); repeatable

sourcestring[] nullable

filter by source: workflow and/or interactive; repeatable

filter by source: workflow and/or interactive; repeatable

dedicatedstring[] nullable

filter by type: shared and/or dedicated; repeatable

filter by type: shared and/or dedicated; repeatable

started_afterstring

only sessions started at/after this RFC3339 time

only sessions started at/after this RFC3339 time

started_beforestring

only sessions started at/before this RFC3339 time

only sessions started at/before this RFC3339 time

ended_afterstring

only sessions de-allocated at/after this RFC3339 time

only sessions de-allocated at/after this RFC3339 time

ended_beforestring

only sessions de-allocated at/before this RFC3339 time

only sessions de-allocated at/before this RFC3339 time

sortstring

sort column: started|ended|status|duration (default started)

sort column: started|ended|status|duration (default started)

orderstring

sort direction: asc|desc (default desc)

sort direction: asc|desc (default desc)

Response

OK

limitinteger required
offsetinteger required
totalinteger required