Skip to Content
Messages

Get message status

GET
/v1/numbers/{phone_number}/messages/{message_uuid}/status

The latest status of a message: submitted, delivered, read or failed.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

phone_number*string

Your WhatsApp number, digits only, e.g. 393401234567.

message_uuid*string

The message_uuid returned by the send.

Response Body

OK

application/json
  1. response
message_uuid*|

ID of the message.

status*string

submitted: handed to WhatsApp. delivered: on the recipient's phone. read: opened. failed: not delivered, see error.

Value in"submitted""delivered""read""failed"
updated_at*string

When the status last changed, UTC.

Formatdate-time
error?|

WhatsApp's error when status is failed, otherwise null.

Example Request
curl -X GET 'https://api.wapiu.ai/v1/numbers/393401234567/messages/3f2b8c1e-7a4d-4e9b-9c2a-5d6e7f8a9b0c/status'
Example Response
{  "message_uuid": "3f2b8c1e-7a4d-4e9b-9c2a-5d6e7f8a9b0c",  "status": "delivered",  "updated_at": "2026-11-22T10:15:00Z",  "error": null}