Skip to main content
GET
List Conversations

Authorizations

Authorization
string
header
required

Query Parameters

fromDateTime
string

Start date and time for filtering conversations (ISO 8601 format)

toDateTime
string

End date and time for filtering conversations (ISO 8601 format)

fromUpdatedAtDateTime
string

Filter by last-updated lower bound (RFC 3339, e.g. 2026-04-01T00:00:00Z; fractional seconds and numeric UTC offsets accepted). Matches conversations whose updatedAt (when the conversation was last updated) is greater than or equal to this value. Only conversations that have an updatedAt are matched; updatedAt reflects changes to the conversation itself, not to related records such as scorecard results or CRM data. When set, results are ordered by updatedAt ascending and paged with cursor, and meta.totalRecords is a lower bound. For incremental sync, start with a full unfiltered pull, then pass the time of the previous sync minus a few minutes and deduplicate by id.

toUpdatedAtDateTime
string

Filter by last-updated upper bound (RFC 3339, e.g. 2026-04-10T23:59:59Z; fractional seconds and numeric UTC offsets accepted). Matches conversations whose updatedAt (when the conversation was last updated) is less than or equal to this value. Only conversations that have an updatedAt are matched. When set, results are ordered by updatedAt ascending and paged with cursor, and meta.totalRecords is a lower bound.

cursor
string

Opaque cursor returned as nextCursor by a previous call with the same filters. Omit on the first page. Requires fromUpdatedAtDateTime or toUpdatedAtDateTime; page is ignored when set.

page
integer

Page number for pagination (starts from 1)

size
integer

Number of items per page

filter[owner.id]
string[]

Filter conversations by owner IDs

filter[owner.email]
string[]

Filter conversations by owner email addresses

filter[title]
string

Filter conversations by title using case-insensitive partial matching

filter[participants.email]
string[]

Filter conversations by participant email addresses

filter[external_opportunity.id]
string[]

Filter conversations by external opportunity IDs

filter[crm_field.entity_code]
enum<string>

CRM platform entity code to filter linked CRM records (e.g. companies, contacts, deals, owners, pipelines, users, account, contact, lead, opportunity, user)

Available options:
companies,
contacts,
deals,
owners,
pipelines,
users,
account,
contact,
lead,
opportunity,
user
filter[crm_field.field_name]
string

CRM record field name (from org_crm_records.record_data) to match on linked CRM records

filter[crm_field.values]
string[]

Exact values to match for the given CRM field. Values are OR'ed together.

filter[team.id]
string[]

Filter conversations by team IDs

filter[hide_internal]
boolean

Exclude internal conversations from results

filter[hide_non_analyzed]
boolean

Exclude conversations that haven't been analyzed

filter[analyzed]
boolean

Filter conversations by analysis status (deprecated, use filter[hide_non_analyzed] instead)

filter[hide_pending]
boolean

Exclude conversations that are pending processing

filter[hide_transcript]
boolean

Omit the transcript field from each conversation in the response. Conversations are not filtered; totals and pagination are unchanged.

filter[hide_failed]
boolean

Exclude conversations that failed processing

filter[include_internal_participants]
boolean

Include internal participants in the response

filter[include_zoom_metadata]
boolean

Include Zoom-specific metadata in the response

filter[include_import_metadata]
boolean
detailedTranscript
boolean
default:false

Include detailed transcript information in the response

Response

Successfully retrieved conversations

data
object[]
Example:
meta
object
Example:
nextCursor
string

Opaque cursor for the next page when fromUpdatedAtDateTime or toUpdatedAtDateTime is set. Absent when there are no more results.