---
title: "List all conversations"
method: GET
path: "/v1/conversations"
tags: ["Conversations"]
---

# List all conversations

`GET /v1/conversations`

Lists all conversations

## Query parameters

- `cursor` integer
- `limit` integer
- `assignedAgentId` string, uuid, nullable
- `status` 'OPEN' | 'SNOOZED' | 'CLOSED' | 'PENDING'
- `customerId` string, uuid, nullable
- `startDate` string, date-time, nullable
- `endDate` string, date-time, nullable
- `subject` string, nullable
- `assignedToZeus` boolean, nullable

## Response `200`

Successful Response

- ExternalApiListResponseExternalConversation
  - `data` ExternalConversation[], required
    - `customerId` string, uuid, required
    - `customer` ExternalCustomer
      - `id` string, uuid, required
      - `externalUserId` string, nullable
      - `companyId` string, uuid, nullable
      - `accountId` string, uuid, nullable
      - `account` WebCompanySchemasExternalAccount
        - `name` string, nullable
        - `email` string, nullable
        - `website` string, nullable
        - `externalId` string, nullable
        - `customFields` object, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `phoneNumber` string, nullable
      - `customFields` object, nullable
      - `defaultSenders` CustomerDefaultSenders
        - `sms` string, nullable
        - `email` string, nullable
      - `lastLoginTime` string, date-time, nullable
      - `createdAt` string, date-time, required
      - `totalConversations` integer, nullable
      - `avgTimeToSolve` integer, nullable
      - `totalSessions` integer, nullable
      - `totalSessionTime` integer, nullable
      - `avgSessionTime` integer, required
    - `startedAt` string, date-time, required
    - `lastMessage` ExternalMessage
      - `id` integer, required
      - `side` string, required
      - `type` string, required
      - `createdAt` string, date-time, required
      - `sentAt` string, date-time, required
      - `agent` ExternalUser
        - `createdAt` string, date-time, nullable
        - `firstName` string, required
        - `lastName` string, nullable
        - `email` string, email, nullable
        - `profileUrl` string, uri, nullable
        - `accessTypes` UserAccessType[], nullable
        - `id` string, uuid, required
      - `customer` ExternalCustomer
        - `id` string, uuid, required
        - `externalUserId` string, nullable
        - `companyId` string, uuid, nullable
        - `accountId` string, uuid, nullable
        - `account` WebCompanySchemasExternalAccount
          - `name` string, nullable
          - `email` string, nullable
          - `website` string, nullable
          - `externalId` string, nullable
          - `customFields` object, nullable
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `email` string, email, nullable
        - `phoneNumber` string, nullable
        - `customFields` object, nullable
        - `defaultSenders` CustomerDefaultSenders
          - `sms` string, nullable
          - `email` string, nullable
        - `lastLoginTime` string, date-time, nullable
        - `createdAt` string, date-time, required
        - `totalConversations` integer, nullable
        - `avgTimeToSolve` integer, nullable
        - `totalSessions` integer, nullable
        - `totalSessionTime` integer, nullable
        - `avgSessionTime` integer, required
      - `text` string, required
      - `channel` string, nullable
      - `attachments` ExternalAttachment[]
        - `name` string, required
        - `url` string, required
        - `size` integer, nullable
      - `deliveryStatus` string, nullable
      - `failedReason` string, nullable
      - `deliveredAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `closedAt` string, date-time, nullable
    - `closedBy` string, uuid, nullable
    - `assignedAt` string, date-time, nullable
    - `assignedBy` string, uuid, nullable
    - `browser` string, nullable
    - `operatingSystem` string, nullable
    - `assignedAgent` ExternalUser
      - `createdAt` string, date-time, nullable
      - `firstName` string, required
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `profileUrl` string, uri, nullable
      - `accessTypes` UserAccessType[], nullable
      - `id` string, uuid, required
    - `number` integer, nullable
    - `csat` CSATResponse
      - `score` string, nullable
      - `comment` string, nullable
    - `statistics` ConversationStatistics
      - `firstResponseTime` integer, nullable
      - `avgResponseTime` integer, nullable
      - `totalResolutionTime` integer, nullable
    - `escalatedAt` string, date-time, nullable
    - `updatedBy` union
      - string, uuid
      - string
    - `assignedAgentId` union
      - string, uuid
      - string
    - `subject` string, nullable
    - `status` 'OPEN' | 'SNOOZED' | 'CLOSED' | 'PENDING'
    - `priority` 'NO_PRIORITY' | 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `tags` union
      - string[]
      - string[]
    - `customFields` object, nullable
    - `snoozedUntil` string, date-time, nullable
    - `assignedTeamId` string, uuid, nullable
    - `assignedToZeus` boolean, nullable
    - `id` string, uuid, required
    - `startedChannel` string, nullable
    - `startedSubChannel` string, nullable
  - `total` integer, nullable
  - `cursor` integer, nullable
  - `limit` integer, nullable

## Other responses

- `422` — Validation Error

---

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