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.

limitinteger

max rows to return (default 50, max 100)

offsetinteger

rows to skip for pagination

searchstring

case-insensitive match on phone/session/workflow

workflow_idstring

only sessions for this workflow

statusstring[] nullable

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

sourcestring[] nullable

filter by source: workflow and/or interactive; repeatable

dedicatedstring[] nullable

filter by type: shared and/or dedicated; repeatable

started_afterstring

only sessions started at/after this RFC3339 time

started_beforestring

only sessions started at/before this RFC3339 time

ended_afterstring

only sessions de-allocated at/after this RFC3339 time

ended_beforestring

only sessions de-allocated at/before this RFC3339 time

sortstring

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

orderstring

sort direction: asc|desc (default desc)

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

limitinteger required

Page size used for this response.

offsetinteger required

Pagination offset used for this response.

totalinteger required

Total number of sessions matching the query.

Example response

{
  "$schema": "/api/v1/PhoneSessionListResponse.json"
}

v12

List sessions

Query parameters

Response

Example response