On this page

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

queuedsendingsentdeliveredread (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.