---
title: "List Conversations"
method: GET
path: "/v1/conversations"
---

# List Conversations

`GET /v1/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.

## Query parameters

- `limit` integer — Maximum number of results per page (1-50)
- `startedAfter` string, nullable — Lower bound for meeting start time (ISO 8601)
- `startedBefore` string, nullable — Upper bound for meeting start time (ISO 8601)
- `type` string, nullable — Filter by meeting type (e.g. EXTERNAL, INTERNAL)
- `title` string, nullable — Filter by meeting title (case-insensitive partial match)
- `attendees` string, 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).
- `crmName` string, nullable — Filter by associated CRM deal or account name (case-insensitive exact-phrase match). Multi-word queries match the full phrase, not individual tokens.
- `sourceId` string, 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.
- `cursor` string, nullable — Opaque pagination cursor from a previous response

## Response `200`

Successful Response

- ListConversationsResponse
  - `conversations` ConversationListItem[], required
    - `conversationId` string, uuid, required
    - `sourceId` string, nullable
    - `title` string, nullable
    - `startTime` string, date-time, required
    - `endTime` string, date-time, required
    - `type` 'INTERNAL' | 'EXTERNAL', required
    - `participants` Participant[], required
      - `name` string, nullable
      - `email` string, nullable
      - `attended` boolean
    - `crm` CRMInfo
      - `id` string, nullable
      - `name` string, nullable
      - `type` 'contact' | 'account' | 'opportunity' | 'lead' | 'owner' | 'activity' | 'task'
  - `pagination` PaginationInfo, required — Cursor-based pagination metadata returned alongside list responses. All public-API list endpoints emit the same shape: pass ``next_cursor`` back as the ``cursor`` query parameter to fetch the next page; check ``has_more`` to know whether more pages exist.
    - `nextCursor` string, nullable
    - `hasMore` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sybill/apis/sybill-api.md) · [All operations](https://skmtc.net/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)