Messages

Get message status

GET/messages/{messageId}Scope messages:send

Returns where a message has got to, with the time of each step. Works for templates sent through this API and for replies sent inside the 24-hour window, whether they came from the API, the inbox or a chatbot. Broadcast and drip messages are reported in the dashboard, not here.

If you would rather be told than ask, register a status webhook and the same changes are pushed to you.

Path parameters

messageIdstringrequired
The messageId a send returned (starts with wamid.).

Good to know

status is one of sent, delivered, read or failed, and only moves forward. A read message also has a deliveredAt, even when WhatsApp skipped the delivered receipt.
No readAt does not mean unread. WhatsApp only reports reads for people who have read receipts turned on.
On a failure, error.code is WhatsApp's code and error.message its reason. 131026 means the number is not on WhatsApp or has blocked you; 131049 means WhatsApp held back a marketing message.
templateName is null for a reply, and type says what kind it was (text, interactive, image and so on). to is null for a reply sent from the inbox or a chatbot rather than over the API.

Errors

Status	Code	When
404	NOT_FOUND	No message with that id was sent from your workspace through the API or as a reply. Received messages are not looked up here.

Plus the errors any endpoint can return, such as a missing key or scope. See Errors.

Request

# macOS, Linux or Git Bash, with WAMAFY_API_KEY set. The quoting does not work in Windows cmd or PowerShell.
curl "https://api.wamafy.com/api/v1/public/messages/wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSQzU" \
  -H "Authorization: Bearer $WAMAFY_API_KEY"

Response 200

{
  "success": true,
  "data": {
    "messageId": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSQzU",
    "to": "919876543210",
    "type": "template",
    "templateName": "order_update",
    "status": "read",
    "sentAt": "2026-10-07T10:00:00.000Z",
    "deliveredAt": "2026-10-07T10:00:02.000Z",
    "readAt": "2026-10-07T10:03:41.000Z",
    "failedAt": null,
    "clickedAt": null,
    "error": null
  }
}

Base URL https://api.wamafy.com/api/v1/public