Message status
Follow a message from submitted to read.
GET
/v1/numbers/{phone_number}/messages/{message_uuid}/statusReference →
After a send is accepted, the message moves through these statuses:
| Status | Meaning |
|---|---|
submitted | WhatsApp accepted the message. |
delivered | It reached the user's phone. |
read | The user opened it. Only if the user has read receipts on. |
failed | It was not delivered. error says why. |
submitted → delivered → read is the normal path. failed can follow submitted. A status never goes back.
Read the status
curl -X GET "$WAPIU_API/v1/numbers/$WAPIU_NUMBER/messages/aaaaaaaa-bbbb-cccc-dddd-000000000000/status" \ -H "Authorization: Bearer $WAPIU_TOKEN"{
"message_uuid": "aaaaaaaa-bbbb-cccc-dddd-000000000000",
"status": "delivered",
"updated_at": "2026-11-22T10:00:05Z",
"error": null
}| Field | Description |
|---|---|
status | The latest status. |
updated_at | When it changed. |
error | Set only when failed. |
A 404 means no status is known yet for that message_uuid.
Push instead of polling
Set a status_webhook and receive every change as it happens. See Webhooks.