Get Message Status

Check the delivery status of a sent message.

Endpoint

GET /v1/whatsapp/messages/{message_id}

Request

Headers

Header	Value
Authorization	Bearer {access_token}

Path Parameters

Parameter	Type	Description
`message_id`	string	The message ID returned from send

Example Request

curl -X GET https://api.apimw.com/v1/whatsapp/messages/wamid.HBgNNjI4MTU1... \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Success Response (200 OK)

{
  "success": true,
  "data": {
    "message_id": "wamid.HBgNNjI4MTU1NTc0NDU2FQIAERgSM0VGMDA0...",
    "to": "+1234567890",
    "type": "text",
    "status": "delivered",
    "timestamps": {
      "sent": "2024-01-15T10:30:00Z",
      "delivered": "2024-01-15T10:30:05Z",
      "read": null
    }
  }
}

Status Values

Status	Description
`sent`	Message sent to WhatsApp servers
`delivered`	Message delivered to recipient's device
`read`	Message was read by recipient
`failed`	Message delivery failed

Tip

Instead of polling for status, use Webhooks to receive real-time status updates.