---
title: "Retrieve a message"
method: GET
path: "/v1/messages/{id}"
tags: ["v1Messages"]
---

# Retrieve a message

`GET /v1/messages/{id}`

Returns a single message by its id. Use GET /v1/conversations/{id}/messages to list the messages of a conversation.

## Path parameters

- `id` string, required

## Response `200`

- MessagePublicDto
  - `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

## Changes

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

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v1/messages/:id/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)