Message status
The lifecycle of a Deliver message, what each status means and how to check it with GET /v1/messages/{id}.
GET /v1/messages/{id} returns the message’s current status and its history in events, each with status, at and detail. You only see messages from your own application and environment; any other id answers 404 with MENSAJE_NO_ENCONTRADO.
Lifecycle
queued → sending → sent → delivered → read (WhatsApp)
| Status | Meaning |
|---|---|
scheduled |
Scheduled for later with scheduleAt (coming soon). |
queued |
Accepted and waiting to be sent. |
sending |
Being handed to the channel. |
sent |
Handed to the channel. |
delivered |
The channel reported delivery. |
read |
The recipient read it (WhatsApp). |
failed |
Could not be sent after the retries. |
suppressed |
The recipient unsubscribed or bounced on this channel. |
blocked |
UAT key and a recipient that isn’t authorized. |
cancelled |
Cancelled before sending (coming soon). |
delivered and read depend on each channel reporting them, and are coming soon on the channels that do.