Get message delivery status
Returns the aggregated delivery status of an outbound message sent by the connected device: pending (sent, no receipt yet) -> delivered -> read -> played. Backed by persisted WhatsApp receipts. For group messages the timestamps reflect the first/any participant.
Returns the aggregated delivery status of an outbound message sent by the connected device: pending (sent, no receipt yet) -> delivered -> read -> played. Backed by persisted WhatsApp receipts. For group messages the timestamps reflect the first/any participant.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Path Parameters
WhatsApp message id (as returned by a send endpoint).
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/messages/3EB0XXXX1234ABCD/status"{ "success": true, "message_id": "3EB0XXXX1234ABCD", "chat_jid": "5511999999999@s.whatsapp.net", "is_group": false, "status": "read", "delivered_at": "2026-06-16T12:00:01Z", "read_at": "2026-06-16T12:00:30Z", "played_at": null}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}Download inbound message media GET
Returns the binary payload of an inbound WhatsApp media message. WUTS serves warm-cached bytes when available and otherwise re-downloads the media on demand over the live whatsmeow socket, requesting retransmission from the sender when the WhatsApp CDN copy has expired.
Mark message(s) as delivered POST
Emits a WhatsApp delivery receipt (double grey ticks) for one or more messages in a chat through the authenticated WUTS device. When message_ids is omitted, the message id from the path is used.