List Sessions

Beta

Authentication

AuthorizationBearer

Retrieve your API Key from Dashboard.

Query parameters

namestringOptional
This is the name of the session to filter by.
assistantIdstringOptional
This is the ID of the assistant to filter sessions by.
squadIdstringOptional
This is the ID of the squad to filter sessions by.
workflowIdstringOptional
This is the ID of the workflow to filter sessions by.
numberE164CheckEnabledbooleanOptionalDefaults to true
This is the flag to toggle the E164 check for the `number` field. This is an advanced property which should be used if you know your use case requires it. Use cases: - `false`: To allow non-E164 numbers like `+001234567890`, `1234`, or `abc`. This is useful for dialing out to non-E164 numbers on your SIP trunks. - `true` (default): To allow only E164 numbers like `+14155551234`. This is standard for PSTN calls. If `false`, the `number` is still required to only contain alphanumeric characters (regex: `/^\+?[a-zA-Z0-9]+$/`). @default true (E164 check is enabled)
extensionstringOptional<=10 characters
This is the extension that will be dialed after the call is answered.
assistantOverridesanyOptional
These are the overrides for the assistant's settings and template variables specific to this customer. This allows customization of the assistant's behavior for individual customers in batch calls.
numberstringOptional3-40 characters
This is the number of the customer.
sipUristringOptional
This is the SIP URI of the customer.
namestringOptional<=40 characters

This is the name of the customer. This is just for your own reference.

For SIP inbound calls, this is extracted from the From SIP header with format "Display Name" <sip:username@domain>.

emailstringOptional<=40 characters
This is the email of the customer.
externalIdstringOptional<=40 characters
This is the external ID of the customer.
pagedoubleOptional>=1
This is the page number to return. Defaults to 1.
sortOrderenumOptional
This is the sort order for pagination. Defaults to 'DESC'.
Allowed values:
limitdoubleOptional0-1000
This is the maximum number of items to return. Defaults to 100.
createdAtGtdatetimeOptional
This will return items where the createdAt is greater than the specified value.
createdAtLtdatetimeOptional
This will return items where the createdAt is less than the specified value.
createdAtGedatetimeOptional
This will return items where the createdAt is greater than or equal to the specified value.
createdAtLedatetimeOptional
This will return items where the createdAt is less than or equal to the specified value.
updatedAtGtdatetimeOptional
This will return items where the updatedAt is greater than the specified value.
updatedAtLtdatetimeOptional
This will return items where the updatedAt is less than the specified value.
updatedAtGedatetimeOptional
This will return items where the updatedAt is greater than or equal to the specified value.
updatedAtLedatetimeOptional
This will return items where the updatedAt is less than or equal to the specified value.

Response

resultslist of objects
metadataobject