Skip to Content
Developers

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:

StatusMeaning
submittedWhatsApp accepted the message.
deliveredIt reached the user's phone.
readThe user opened it. Only if the user has read receipts on.
failedIt 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
}
FieldDescription
statusThe latest status.
updated_atWhen it changed.
errorSet 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.

On this page