List sessions
List sessions, ordered from newest to
oldest by created_at. The optional filters are combined, so a session
must match every supplied filter.
The endpoint does not use pagination. It returns all matching sessions when
limit is omitted. When limit is set, it caps the number of filtered
sessions returned, and has_more indicates whether additional matches
exist.
Authentication
Send Authorization: Bearer <app_uuid>:<api_key> using an active API key. See Authentication for details.
Query parameters
Optional cap on the number of sessions to return. Omit to return
every matching session; when set, at most this many are returned and
has_more indicates whether more matched. A non-positive value
returns 400.
Filter to sessions whose caller exactly matches this canonical E.164 value. The schema validates country-neutral syntax only; this historical-data filter does not apply current trunk policy.
Filter to sessions whose called DID exactly matches this canonical E.164 value. The schema validates country-neutral syntax only; this historical-data filter does not apply current trunk policy.
Filter to sessions in this lifecycle state. Any other value returns 400.
Inclusive lower bound on created_at (RFC 3339 UTC string).
Only sessions created at or after this instant are returned. An
invalid RFC 3339 value returns 400.
Exclusive upper bound on created_at (RFC 3339 UTC string).
Only sessions created strictly before this instant are returned. An
invalid RFC 3339 value returns 400.
Response headers
Server-owned W3C Trace Context for correlating this response with support and observability data. It is present on successful and error responses. A valid incoming traceparent is linked to, but never becomes, the server-owned trace identifier.