Skip to main content
GET
List Interactions
Learn about AI phone calls and SMS conversations before working with their combined interaction records. 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.

updated_at_gte
string<date-time>

Filter interactions last updated at or after this datetime (ISO 8601 format). Reflects the last change to the interaction record itself. For external-channel interactions this compares against the underlying session's last update time.

updated_at_lte
string<date-time>

Filter interactions last updated at or before this datetime (ISO 8601 format).

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
Last modified on September 3, 2026