latestOpenAPI 3.1.02026-08-13356696.3 KB

f499ec011b17

List Conversations

List organization-visible conversations.

Requires the Export permission (read scope). Private conversations owned by individual users are excluded. Results use cursor-based pagination; sourceId accepts a custom source UUID or one of the native meeting-provider identifiers listed below.

get/v1/conversations

Query parameters

limitinteger

Maximum number of results per page (1-50)

Maximum number of results per page (1-50)

startedAfterstring nullable

Lower bound for meeting start time (ISO 8601)

Lower bound for meeting start time (ISO 8601)

startedBeforestring nullable

Upper bound for meeting start time (ISO 8601)

Upper bound for meeting start time (ISO 8601)

typestring nullable

Filter by meeting type (e.g. EXTERNAL, INTERNAL)

Filter by meeting type (e.g. EXTERNAL, INTERNAL)

titlestring nullable

Filter by meeting title (case-insensitive partial match)

Filter by meeting title (case-insensitive partial match)

attendeesstring nullable

Filter by an attendee. Accepts three shapes: a participant name fragment (e.g. John, case-insensitive partial match), a full participant email (e.g. alice@acme.com, exact match), or a participant company domain (e.g. @acme.com or acme.com, exact match against the email domain).

Filter by an attendee. Accepts three shapes: a participant name fragment (e.g. John, case-insensitive partial match), a full participant email (e.g. alice@acme.com, exact match), or a participant company domain (e.g. @acme.com or acme.com, exact match against the email domain).

crmNamestring nullable

Filter by associated CRM deal or account name (case-insensitive exact-phrase match). Multi-word queries match the full phrase, not individual tokens.

Filter by associated CRM deal or account name (case-insensitive exact-phrase match). Multi-word queries match the full phrase, not individual tokens.

sourceIdstring nullable

Filter by conversation origin. Accepts a reserved native string (e.g. sybill, gong, chorus, fathom, grain, mindtickle, avoma, fireflies, zoho_meetings, uploaded_call, uploaded_transcript, zoom_phone, outreach_dialer, nooks_dialer, ringcentral_dialer, aircall_dialer, hubspot_dialer), or a public-API IngestSource UUID to narrow to conversations ingested through that source. sybill includes desktop-notetaker recordings. Omitted means all origins.

Filter by conversation origin. Accepts a reserved native string (e.g. sybill, gong, chorus, fathom, grain, mindtickle, avoma, fireflies, zoho_meetings, uploaded_call, uploaded_transcript, zoom_phone, outreach_dialer, nooks_dialer, ringcentral_dialer, aircall_dialer, hubspot_dialer), or a public-API IngestSource UUID to narrow to conversations ingested through that source. sybill includes desktop-notetaker recordings. Omitted means all origins.

cursorstring nullable

Opaque pagination cursor from a previous response

Opaque pagination cursor from a previous response

Response

Successful Response