---
title: "List conversation messages"
method: GET
path: "/v1/conversations/{id}/messages"
tags: ["Conversations"]
---

# List conversation messages

`GET /v1/conversations/{id}/messages`

Lists conversation messages

## Path parameters

- `id` string, uuid, required

## Query parameters

- `cursor` integer
- `limit` integer

## Response `200`

Successful Response

- ExternalApiListResponseExternalMessage
  - `data` ExternalMessage[], required
    - `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
  - `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/d1e65d4df262/schema)