---
title: "Listar mensagens de um contato"
method: GET
path: "/v1/message"
tags: ["Message"]
---

# Listar mensagens de um contato

`GET /v1/message`

Retorna mensagens de um contato/chat com paginação.

## Query parameters

- `contact` string, required
- `page` number
- `limit` number

## Response `200`

Lista de mensagens retornada com sucesso

- MessagesListResponseDto
  - `messages` MessageResponseDto[], required
    - `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)
  - `pagination` MessagesPaginationDto, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, required
    - `hasPreviousPage` boolean, required

## Other responses

- `400` — Requisição inválida — contact ausente ou inválido
- `401` — Não autorizado — chave de empresa inválida ou ausente
- `404` — Contato não encontrado

---

[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)