Skip to main content

​
Message Status

GET https://pilotstatus.com.br/v1/messages/{messageId}
After sending a message and receiving an id (e.g., msg_abc) from POST /v1/messages/send, query its current status.
{messageId} accepts the internal message id returned by the send endpoint, the correlationId, or the provider WhatsApp message ID (wamid).

​
Example

curl "https://pilotstatus.com.br/v1/messages/msg_abc" \
  -H "x-api-key: ps_your_key_here"

​
Response (200)

{
  "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",
  "readAt": null,
  "errorMessage": null
}

​
Statuses

StatusMeaning
QUEUEDQueued / waiting for processing
SENTSent to the provider/WhatsApp
DELIVEREDDelivered to the device
READMarked as read
FAILEDFailed (check errorMessage when available)
CANCELEDScheduled send canceled via DELETE /v1/messages/cancel
Read receipts: READ status and readAt are only available when the contact who received the message has read receipts enabled in WhatsApp (Settings > Privacy > Read receipts). Otherwise the lifecycle may stop at DELIVERED. The same applies to Logs and the message.read webhook.

​
Common errors

  • 401 — missing/invalid API key header (x-api-key / x-api-key-id).
  • 404 — message not found within the key’s scope.