Retrieve the latest status and lifecycle events for one message.
Message Status Report
Summary
Retrieve the latest status and lifecycle events for one message.
Prerequisites
- Authorization: Bearer w91_live_xxx
- Content-Type: application/json for JSON requests
Related documentation
Use this endpoint to look up one message by Meta message ID. Whats91 also accepts a local report UID or message key as a fallback.
Endpoint: GET /api/v2/reports/messages/status.
GET
/api/v2/reports/messages/status| Parameter | Type | Required | Description |
|---|---|---|---|
messageId | string | Required | Meta message ID first; local report UID or message key is accepted as a fallback. |
senderId | string | Optional | WhatsApp sender phone number for multi-number tokens. |
storage | string | Optional | live or archive. |
Get message status
curl "https://graph.whats91.com/api/v2/reports/messages/status?messageId=wamid.xxxxx" \
-H "Authorization: Bearer w91_live_xxx"Status response
{
"success": true,
"message": "Message status retrieved",
"data": {
"message": {
"reportUid": "msg_uid",
"messageId": "wamid.xxxxx",
"receiver": "918888888888",
"latestStatus": "read"
},
"events": [
{ "eventType": "status", "status": "sent", "occurredAt": "2026-06-05T07:59:00.000Z" },
{ "eventType": "status", "status": "read", "occurredAt": "2026-06-05T08:02:00.000Z" }
]
}
}Not found response
{
"success": false,
"message": "Message not found",
"error_code": "MESSAGE_NOT_FOUND"
}SDK Examples
Use these examples as starting points for server-side implementations.
cURL
curl -X GET "https://graph.whats91.com/api/v2/reports/messages/status" \
-H "Authorization: Bearer w91_live_xxx"Node.js
const response = await fetch("https://graph.whats91.com/api/v2/reports/messages/status", {
method: "GET",
headers: {
"Authorization": "Bearer w91_live_xxx",
"Content-Type": "application/json"
}
});
const data = await response.json();
console.log(data);PHP
$ch = curl_init("https://graph.whats91.com/api/v2/reports/messages/status");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer w91_live_xxx",
"Content-Type: application/json"
]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Python
import requests
response = requests.request(
"GET",
"https://graph.whats91.com/api/v2/reports/messages/status",
headers={
"Authorization": "Bearer w91_live_xxx",
"Content-Type": "application/json",
}
)
print(response.json())C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer w91_live_xxx");
var request = new HttpRequestMessage(HttpMethod.Get, "https://graph.whats91.com/api/v2/reports/messages/status");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());