> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectalk.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Mensagens

> Recupere o histórico de mensagens da instância ou organização com filtros opcionais.

## Parâmetros

### Query

<ParamField query="page" type="number" default={1}>
  Número da página.
</ParamField>

<ParamField query="limit" type="number" default={50}>
  Quantidade de mensagens por página.
</ParamField>

<ParamField query="status" type="string">
  Filtrar por status: `sent`, `delivered`, `read`, `failed`, `pending`.
</ParamField>

<ParamField query="from" type="string">
  Data de início (ISO 8601 ou `YYYY-MM-DD`). Exemplo: `2026-01-01`.
</ParamField>

<ParamField query="to" type="string">
  Data de fim (ISO 8601 ou `YYYY-MM-DD`). Exemplo: `2026-01-31`.
</ParamField>

<ParamField query="messageId" type="string">
  Filtrar por ID de mensagem da Meta (`wamid`).
</ParamField>

<ParamField query="direction" type="string">
  Filtrar por direção: `inbound` ou `outbound`.
</ParamField>

## Exemplo de Requisição

```bash theme={null}
curl --request GET \
  --url 'https://apis.vectalk.com.br/api/messages?page=1&limit=20&status=delivered&direction=outbound' \
  --header 'Authorization: Bearer {seu_token}'
```

## Resposta

```json theme={null}
{
  "data": [
    {
      "id": "msg_...",
      "waMessageId": "wamid.HBgLNTUx...",
      "to": "5511999999999",
      "type": "text",
      "status": "delivered",
      "direction": "outbound",
      "createdAt": "2026-01-01T10:00:00Z"
    }
  ],
  "total": 320,
  "page": 1,
  "limit": 20
}
```