Read one tenant- and sender-scoped order with items, charges, events, payment, and readiness.

Get Order

Summary

Read one tenant- and sender-scoped order with items, charges, events, payment, and readiness.

Prerequisites

Authorization: Bearer w91_live_xxx
Content-Type: application/json for JSON requests

Related documentation

Orders List Orders Send Order Create and Send

GET/api/v3/orders/{orderUid}

Retrieve one order by UID.

Parameter	Type	Required	Description
`orderUid`	string	Required	Order UID returned by create.
`sender_id`	string	Optional	WhatsApp sender that owns the order.

cURL

curl "https://graph.whats91.com/api/v3/orders/ord_abc123?sender_id=919999999999" \
  -H "Authorization: Bearer w91_live_xxx"

200 OK (detail fields)

{
  "success": true,
  "message": "Order retrieved",
  "data": {
    "order": {
      "uid": "ord_abc123",
      "status": "sent",
      "payment_status": "pending",
      "items": [
        {
          "name": "Masala Dosa",
          "retailer_id": "SKU-101",
          "product_uid": "prod_masala_dosa",
          "quantity": 1,
          "unit_price": "120.00",
          "line_total": "120.00",
          "item_type": "catalog",
          "image_url": "https://cdn.example.com/dosa.jpg"
        }
      ],
      "charges": {
        "tax": "18.00",
        "tax_description": "GST",
        "shipping": "0.00",
        "discount": "10.00"
      },
      "events": [
        {
          "event_type": "order.status_changed",
          "from_status": "draft",
          "to_status": "sent",
          "created_at": "2026-08-06T09:12:00.000Z"
        }
      ],
      "payment": { "uid": "pay_abc123", "status": "initiated" },
      "readiness": { "ready_for_payment": true, "reasons": [] }
    }
  },
  "metadata": {
    "apiVersion": "v3",
    "requestId": "request-uuid"
  }
}

Note

Unknown UIDs, orders in another tenant, and orders on another sender all return the same 404 ORDERS_NOT_FOUND. The response never reveals whether a UID exists elsewhere.

events[] excludes actor IDs, audit notes, and internal numeric IDs.
payment is the latest public-safe payment request summary.
readiness reports ready_for_payment plus safe reason codes.

SDK Examples

Use these examples as starting points for server-side implementations.

cURL

curl -X GET "https://graph.whats91.com/api/v3/orders/{orderUid}" \
  -H "Authorization: Bearer w91_live_xxx"

Node.js

const response = await fetch("https://graph.whats91.com/api/v3/orders/{orderUid}", {
  method: "GET",
  headers: {
    "Authorization": "Bearer w91_live_xxx"
  }
});

const data = await response.json();
console.log(data);

PHP

$ch = curl_init("https://graph.whats91.com/api/v3/orders/{orderUid}");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer w91_live_xxx"
  ]
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import requests

response = requests.request(
    "GET",
    "https://graph.whats91.com/api/v3/orders/{orderUid}",
    headers={
        "Authorization": "Bearer w91_live_xxx",
    }
)

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/v3/orders/{orderUid}");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Related APIs

Orders

Create a merchant draft order with catalog products or custom items.

List Orders

List and search orders for one sender with status, payment, source, and date filters.

Send Order

Create and send the exact-amount WhatsApp payment request for an existing draft order.

Create and Send

Create an order and send its payment request in one call, with idempotency protection.