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

List Orders

Summary

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

Prerequisites

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

Related documentation

Orders Get Order Send Order Create and Send

Returns orders for one sender, newest first. List rows are a reduced projection: item lines, event history, payment-provider references, and raw payloads are excluded. Read a single order to get the full detail.

GET/api/v3/orders

List orders for the resolved sender.

Parameter	Type	Required	Description
`sender_id`	string	Optional	WhatsApp sender to scope the list to.
`status`	string	Optional	Order status filter.
`payment_status`	string	Optional	Payment status filter.
`source`	string	Optional	merchant or whatsapp.
`q`	string	Optional	Search by display order reference, recipient phone, or recipient name.
`date_from`	string	Optional	Inclusive start date, YYYY-MM-DD.
`date_to`	string	Optional	Inclusive end date, YYYY-MM-DD.
`limit`	integer	Optional	Rows per request, 1 to 100. Default 25.
`offset`	integer	Optional	Rows to skip. Default 0.

cURL

curl "https://graph.whats91.com/api/v3/orders?sender_id=919999999999&source=merchant&payment_status=paid&limit=25&offset=0" \
  -H "Authorization: Bearer w91_live_xxx"

200 OK

{
  "success": true,
  "message": "Orders retrieved",
  "data": {
    "senderId": "919999999999",
    "orders": [
      {
        "uid": "ord_abc123",
        "reference": "ORD-1786000000000-A1B2",
        "source": "merchant",
        "status": "sent",
        "payment_status": "paid",
        "currency": "INR",
        "total_amount": "300.00",
        "item_count": 2,
        "recipient": { "phone": "919876543210", "name": "Restaurant Guest" },
        "created_at": "2026-08-06T09:00:00.000Z",
        "updated_at": "2026-08-06T09:12:00.000Z"
      }
    ],
    "pagination": {
      "limit": 25,
      "offset": 0,
      "count": 25,
      "total": 74,
      "has_more": true
    }
  },
  "metadata": {
    "apiVersion": "v3",
    "requestId": "request-uuid"
  }
}

SDK Examples

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

cURL

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

Node.js

const response = await fetch("https://graph.whats91.com/api/v3/orders", {
  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");
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",
    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");

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.

Get Order

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

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.