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

# GET /v1/messages/{messageId} — Status da Mensagem

> Consulte o status atual de entrega de uma mensagem do WhatsApp enviada.

# Status da Mensagem

```text theme={null}
GET https://pilotstatus.com.br/v1/messages/{messageId}
```

Após enviar uma mensagem e receber um `id` (por exemplo, `msg_abc`) de [`POST /v1/messages/send`](/pt-BR/api/messages/send), consulte seu status atual.

<Frame caption="Detalhes do Log no painel — a mensagem renderizada, o template, o status ao vivo (Lida) e o mesmo messageId que você consulta pela API.">
  <img src="https://mintcdn.com/iaxp/2jtY8yYNn4_WyOg5/images/dashboard/log-details.png?fit=max&auto=format&n=2jtY8yYNn4_WyOg5&q=85&s=8444a52c11cdf048c4aba2c61cadeb65" alt="Modal Detalhes do Log mostrando o balão da mensagem renderizada com botões de resposta rápida, nome do template, status Lida, data e hora, ID da mensagem com botão de copiar, variáveis e as ações Reenviar e Trace completo" width="1920" height="914" data-path="images/dashboard/log-details.png" />
</Frame>

<Note>
  `{messageId}` aceita o `id` interno da mensagem retornado pelo endpoint de envio, o `correlationId` ou o ID de mensagem do WhatsApp do provedor (wamid).
</Note>

## Exemplo

<CodeGroup>
  ```bash x-api-key theme={null}
  curl "https://pilotstatus.com.br/v1/messages/msg_abc" \
    -H "x-api-key: ps_your_key_here"
  ```

  ```bash x-api-key-id theme={null}
  curl "https://pilotstatus.com.br/v1/messages/msg_abc" \
    -H "x-api-key-id: ck_xxx"
  ```
</CodeGroup>

## Resposta (200)

```json theme={null}
{
  "id": "msg_abc",
  "status": "SENT",
  "correlationId": "corr_123",
  "destinationNumber": "+5511999999999",
  "template": "welcome_message",
  "createdAt": "2026-02-24T15:00:00.000Z",
  "sentAt": "2026-02-24T15:00:05.000Z",
  "deliveredAt": "2026-02-24T15:00:07.000Z",
  "readAt": null,
  "externalMessageId": "wamid.HBgLNTUxMTk5OTk5OTk5",
  "errorMessage": null
}
```

## Status

| Status      | Significado                                                                             |
| ----------- | --------------------------------------------------------------------------------------- |
| `QUEUED`    | Na fila / aguardando processamento                                                      |
| `SENT`      | Enviada ao provedor/WhatsApp                                                            |
| `DELIVERED` | Entregue ao dispositivo                                                                 |
| `READ`      | Marcada como lida                                                                       |
| `FAILED`    | Falhou (verifique `errorMessage` quando disponível)                                     |
| `CANCELED`  | Envio agendado cancelado via [`DELETE /v1/messages/cancel`](/pt-BR/api/messages/cancel) |

<Note>
  **Confirmações de leitura:** o status `READ` e `readAt` só estão disponíveis quando o **contato que recebeu a mensagem** tem as **confirmações de leitura** ativadas no WhatsApp (*Configurações > Privacidade > Confirmações de leitura*). Caso contrário, o ciclo de vida pode parar em `DELIVERED`. O mesmo se aplica aos Logs e ao webhook `message.read`.
</Note>

## Erros comuns

* `401` — cabeçalho de chave de API ausente/inválido (`x-api-key` / `x-api-key-id`).
* `404` — mensagem não encontrada dentro do escopo da chave.