---
title: "Buscar mensagem por ID"
method: GET
path: "/v1/message/{id}"
tags: ["Message"]
---

# Buscar mensagem por ID

`GET /v1/message/{id}`

Retorna os dados de uma mensagem específica.

## Path parameters

- `id` string, required

## Response `200`

Mensagem retornada com sucesso

- MessageDetailResponseDto
  - `id` string, uuid, required — UUID da mensagem (`Message.id`)
  - `chatId` string, uuid, required — UUID do chat/contato ao qual a mensagem pertence (`Chat.id`)
  - `content` object — Message content (text)
  - `type` object — Message type
  - `outbound` boolean, required — True if message was sent by us
  - `deliveryStatus` object — Delivery status
  - `sentAt` string, nullable — Data/hora de envio (ISO 8601); `null` se ainda não enviada/agendada.
  - `scheduledFor` object — Scheduled send time (ISO 8601)
  - `mediaUrl` object — Media file URL
  - `mediaCaption` object — Media caption
  - `audioText` object — Audio transcription text
  - `createdAt` string, required — Message creation date (ISO 8601)
  - `errorDetails` object — Detalhes do erro quando `deliveryStatus` é `ERRO` (origem: metadata da mensagem)

## Other responses

- `400` — ID inválido ou rejeitado pelo banco (UUID malformado)
- `401` — Não autorizado — chave de empresa inválida ou ausente
- `404` — Mensagem não encontrada neste workspace
- `500` — Erro interno ao consultar o banco (ex.: indisponibilidade do serviço de dados)

---

[API](https://skmtc.dev/liderhub/apis/api-liderhub.md) · [All operations](https://skmtc.dev/liderhub/apis/api-liderhub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liderhub/api-liderhub/revisions/cce9b43211ac/schema)