Skip to main content
GET
List Interactions
By default, this endpoint returns native calls and conversations only. Pass include_external_channels=true to include external-channel sessions, grouped one per session, alongside native interactions. The type field identifies whether each interaction is a call, conversation, email, sms, or external_channel.

Authorizations

Authorization
string
header
required

Query Parameters

page
integer | null
default:1
page_size
integer | null
default:20
status
string

Filter by interaction status. Multiple values can be provided separated by commas.

modality
enum<string>

Filter by interaction modality (voice or text)

Available options:
voice,
text
agent_id
string

Filter by agent group UUID. Multiple values can be provided separated by commas. Returns interactions from all versions of the specified agent(s).

agent_version_id
string<uuid>

Filter by specific agent version UUID. Returns interactions from only the specified agent version.

transferred
boolean

Filter by whether the interaction was transferred

include_external_channels
boolean
default:false

External-channel calls (uploaded or ingested from external sources, grouped as one interaction per session) are excluded by default. Pass true to include them alongside native calls and conversations.

created_at_gte
string<date-time>

Filter interactions created at or after this datetime (ISO 8601 format). For external-channel interactions this compares against the call (leg start) time rather than the returned created_at ingestion timestamp.

created_at_lte
string<date-time>

Filter interactions created at or before this datetime (ISO 8601 format). For external-channel interactions this compares against the call (leg start) time rather than the returned created_at ingestion timestamp.

sort_by
enum<string>
default:created_at

Field to sort results by

Available options:
created_at,
updated_at,
started_at,
ended_at,
duration,
status
sort_direction
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

Successful Response

interactions
InteractionDetailsResponse · object[]
required
total_count
integer
required
page
integer
required
page_size
integer
required
total_pages
integer
required
filters
Filters · object
sorting
Sorting · object