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

# List conversation messages

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

Lists the messages of a conversation, newest first by default. The conversation id is the `call.customerPlatformId` returned by the sessions endpoints. Paginate with the returned `nextCursor`.

## Path parameters

- `id` number, required

## Query parameters

- `limit` number
- `cursor` string
- `order` 'asc' | 'desc'
- `created_at_from` string
- `created_at_to` string

## Response `200`

- MessageCursorPaginatedResponseDto
  - `data` MessagePublicDto[], required
    - `id` string, required — Id da mensagem. Numérico para mensagens comuns; pode ser um ObjectId para mensagens sem id numérico.
    - `conversationId` number, required — Id da conversa (contato no canal) a que a mensagem pertence
    - `callId` number, nullable — Id da sessão de atendimento (call) da mensagem
    - `channelId` number, nullable — Id do canal pelo qual a mensagem passou
    - `sender` 'contact' | 'operator' | 'bot' | 'note' | 'system', required
    - `type` number, required — Tipo bruto: 0 comum, 1 sistema, 2 nota interna, 3 bot, 4 e-mail
    - `operatorId` number, nullable
    - `operatorName` string, nullable
    - `contactName` string, nullable
    - `content` string, required — Conteúdo bruto como armazenado (normalmente um Quill Delta serializado)
    - `text` string, required — Texto extraído de `content`
    - `media` MessageMediaDto[] — Mídias extraídas de `content`
      - `kind` string, required — Tipo da mídia (image, video, audio, file...)
      - `url` string, required
    - `isMedia` boolean, required
    - `fileName` string, nullable
    - `externalId` string, nullable — Id da mensagem na plataforma de origem (ex.: WhatsApp)
    - `replyTo` object, nullable — Referência da mensagem respondida, quando houver
    - `status` number, nullable — Status de envio: 0 enviada ao módulo, 2 enviada à API, 4 aguardando reenvio, 6 entregue, 8 erro
    - `isSent` boolean, required
    - `isError` boolean, required
    - `errorDescription` string, nullable
    - `isDeleted` boolean, required
    - `isScheduled` boolean, required
    - `isForwarding` boolean, required
    - `viewedAt` string, nullable — Quando a mensagem foi visualizada pelo destinatário
    - `createdAt` string, required
  - `nextCursor` string, nullable, required — Cursor for the next page. Null if there are no more results.

## Changes

- **2026-09-15** `b2a10af596db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v1/conversations/:id/messages/get.md)

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)