Skip to main content

Message Status

After sending a message and receiving an id (e.g., msg_abc) from POST /v1/messages/send, query its current status. To list and filter many messages (sent and received), see GET /v1/messages.
Log Details modal showing the rendered message bubble with quick-reply buttons, template name, Read status, timestamp, message ID with copy button, variables, and Resend and Full trace actions

Log Details in the dashboard — the rendered message, template, live status (Read), and the same messageId you query via the API.

{messageId} accepts the internal message id returned by the send endpoint, the correlationId, or the provider WhatsApp message ID (wamid).

Example

Response (200)

Statuses

Read receipts: READ status and readAt are only available when the contact who received the message has read receipts enabled in WhatsApp (Settings > Privacy > Read receipts). Otherwise the lifecycle may stop at DELIVERED. The same applies to Logs and the message.read webhook.

Common errors

  • 401 — missing/invalid API key header (x-api-key / x-api-key-id).
  • 404 — message not found within the key’s scope.