---
title: "List Conversations (Optimized)"
method: GET
path: "/conversations/list"
tags: ["Conversation"]
---

# List Conversations (Optimized)

`GET /conversations/list`

Optimized alias for GET /conversations. Uses a batch query path that pre-fetches edges in a single pass, making it significantly faster for large result sets. Behavioural differences from /conversations: (1) extractedIntelligence and confirmedExtractedIntelligence are omitted by default — pass with_crm_records=true to include them; (2) empty conversations are not excluded; All filter parameters are identical to /conversations.

## Query parameters

- `fromDateTime` string
- `toDateTime` string
- `page` integer
- `size` integer
- `filter[owner.id]` string[]
- `filter[owner.email]` string[]
- `filter[title]` string
- `filter[participants.email]` string[]
- `filter[external_opportunity.id]` string[]
- `filter[crm_field.entity_code]` 'companies' | 'contacts' | 'deals' | 'owners' | 'pipelines' | 'users' | 'account' | 'contact' | 'lead' | 'opportunity' | 'user'
- `filter[crm_field.field_name]` string
- `filter[crm_field.values]` string[]
- `filter[team.id]` string[]
- `filter[hide_internal]` boolean
- `filter[hide_non_analyzed]` boolean
- `filter[analyzed]` boolean
- `filter[hide_pending]` boolean
- `filter[hide_transcript]` boolean
- `filter[hide_failed]` boolean
- `filter[include_internal_participants]` boolean
- `filter[include_zoom_metadata]` boolean
- `filter[include_import_metadata]` boolean
- `detailedTranscript` boolean
- `withCrmRecords` boolean
- `withIntelligenceItems` boolean

## Response `200`

Successfully retrieved conversations

- ConversationsResponse
  - `data` Conversation[]
    - `type` 'conversations'
    - `id` string
    - `attributes` object
      - `uuid` string
      - `transcript` object
      - `boards` ConversationBoard[]
        - `uuid` string
        - `board` Board
          - `uuid` string
          - `name` string
          - `columns` Column[]
            - `id` string
            - `title` string
            - `children` Battlecard[]
              - …
          - `team` Team — Represents a team in the system with its properties and hierarchical structure
            - `uuid` string — Unique identifier of the team
            - `name` string — Name of the team
            - `phrases` string[] — List of keywords or phrases associated with the team
            - `slackConnection` SlackConnection — Represents the Slack integration details for a team
              - …
            - `domain` string — Domain associated with the team
            - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
            - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
            - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
            - `organizationUUID` string — UUID of the organization this team belongs to
            - `children` Team[] — List of child teams if this team has a hierarchical structure
          - `teamUUID` string
        - `battlecards` ConversationBoardBattlecard[]
          - `uuid` string
          - `activatedBattlecardID` string
          - `hidden` boolean
          - `feedbackAction` string
      - `finishedAt` string, date-time
      - `title` string
      - `liveStreamStartedAt` string, date-time
      - `liveStreamEndedAt` string, date-time
      - `talktracks` ConversationTalktrack[]
        - `uuid` string
        - `items` ConversationTalktrackItem[]
          - `uuid` string
          - `activatedItemId` string
          - `done` boolean
      - `createdAt` string, date-time
      - `userUUID` string
      - `user` User
        - `uuid` string — The unique identifier of the user.
        - `email` string — The email address of the user.
        - `firstName` string — The first name of the user.
        - `lastName` string — The last name of the user.
        - `createdAt` string — The date and time the user was created.
        - `deletedAt` string — The date and time the user was deactivated.
        - `transcriptLang` string — The preferred transcript language for the user.
        - `joinOutsideHostMeetings` boolean — Indicates if the user can join meetings outside their host organization.
        - `realTimeCapabilities` boolean — Indicates if the user has real-time transcription capabilities.
        - `settings` UserSettings
          - `realTimeCapabilitiesOFF` boolean
          - `autoCalculateCRMFields` boolean
          - `joinWhenIAmHostAndAlone` boolean
          - `joinWhenIAmHostWithPeers` boolean
          - `joinWhenPeerIsHost` boolean
          - `joinWhenUnlicensedPeerIsHost` boolean
          - `dealsEnabled` boolean
        - `botName` string — The name of the bot associated with the user.
        - `botImageURL` string — The URL of the bot's profile image.
        - `primaryTeamUUID` string — The UUID of the user's primary team.
        - `organizationRoleUUID` string — The UUID of the user's role in the organization.
        - `roles` Role[] — A list of roles assigned to the user.
          - `uuid` string
          - `name` string
          - `type` string
        - `showReferralScreen` boolean — Whether the user is shown a referral screen.
        - `seatType` string — The type of seat assigned to the user.
        - `teams` Team[] — A list of teams assigned to the user.
          - `uuid` string — Unique identifier of the team
          - `name` string — Name of the team
          - `phrases` string[] — List of keywords or phrases associated with the team
          - `slackConnection` SlackConnection — Represents the Slack integration details for a team
            - `id` string — Slack connection identifier
            - `info` SlackTeamInfo — Information about a connected Slack team
              - …
          - `domain` string — Domain associated with the team
          - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
          - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
          - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
          - `organizationUUID` string — UUID of the organization this team belongs to
          - `children` Team[] — List of child teams if this team has a hierarchical structure
      - `team` Team — Represents a team in the system with its properties and hierarchical structure
        - `uuid` string — Unique identifier of the team
        - `name` string — Name of the team
        - `phrases` string[] — List of keywords or phrases associated with the team
        - `slackConnection` SlackConnection — Represents the Slack integration details for a team
          - `id` string — Slack connection identifier
          - `info` SlackTeamInfo — Information about a connected Slack team
            - `id` string — Slack team identifier
            - `name` string — Name of the Slack team
        - `domain` string — Domain associated with the team
        - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
        - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
        - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
        - `organizationUUID` string — UUID of the organization this team belongs to
        - `children` Team[] — List of child teams if this team has a hierarchical structure
      - `teamUUID` string
      - `extractedIntelligence` object
      - `confirmedExtractedIntelligence` object
      - `externalIntelligenceOpportunityID` string, required
      - `crmExportStatus` 'PENDING' | 'EXPORTED' | 'DISMISSED'
      - `archived` boolean
      - `externalOpportunity` CRMExportOpportunity, required
        - `uuid` string
        - `title` string
      - `videoUID` string
      - `videoStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
      - `bots` ConversationBot[]
        - `uuid` string
        - `status` BotStatus
          - `code` string
          - `message` string
          - `createdAt` string, date-time
        - `meetingUrl` string — The original meeting URL used to invite the bot
      - `transcriptStatus` string
      - `participants` Participant[]
        - `id` string
        - `email` string
        - `organizer` boolean
        - `name` string
        - `status` string
      - `attendees` Participant[]
        - `id` string
        - `email` string
        - `organizer` boolean
        - `name` string
        - `status` string
      - `referenceable` boolean
      - `private` boolean
      - `mediaStorageStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
      - `importStatus` 'NONE' | 'PENDING' | 'IN_PROGRESS' | 'FINISHED' | 'DISCARDED' | 'FAILED'
      - `scorecardResults` ScorecardResult[]
        - `uuid` string
        - `title` string
        - `summary` ScorecardResultSummary
          - `min` integer
          - `max` integer
          - `averageScore` number, float
          - `summaryText` string
        - `items` ScorecardItemResult[]
          - `uuid` string
          - `title` string
          - `status` 'CALCULATED' | 'CALCULATING'
          - `type` 'NUMERIC'
          - `position` integer
          - `numericResult` NumericScorecardResult
            - `min` integer
            - `max` integer
            - `score` integer
          - `description` string
          - `evidences` string[]
          - `scorecardItemUUID` string
      - `labels` object
      - `labelTagsToFilterIfNA` string[]
      - `deprecatedLabelCategories` string[]
      - `isInternal` boolean
      - `mediaDuration` number, float
      - `dealUUID` string, required
      - `emailTemplateID` string
      - `linkedCrmRecords` LinkedCrmRecord[]
        - `id` string, required
        - `code` string, required
      - `externalAccounts` LinkedCrmRecord[]
        - `id` string, required
        - `code` string, required
      - `externalContacts` LinkedCrmRecord[]
        - `id` string, required
        - `code` string, required
      - `isEmpty` boolean
      - `zoomMetadata` ZoomMetadata, required
        - `calleeName` string, required
        - `calleeNumber` string, required
        - `callerName` string, required
        - `callerNumber` string, required
      - `importMetadata` object, required
      - `zoomMeetingJoinUrl` string — The Zoom meeting join URL if the conversation was recorded from a Zoom meeting
      - `googleMeetJoinUrl` string — The Google Meet join URL if the conversation was recorded from a Google Meet
      - `microsoftTeamsJoinUrl` string — The Microsoft Teams meeting join URL if the conversation was recorded from a Teams meeting
      - `webexJoinUrl` string — The Webex meeting join URL if the conversation was recorded from a Webex meeting
    - `links` Links
      - `self` string
      - `related` string
  - `links` Links
    - `self` string
    - `related` string
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401` — Authentication failed - valid API key required
- `default` — Unexpected error occurred

---

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