Read billing totals and category breakdowns.

Billing Summary

Summary

Read billing totals and category breakdowns.

Prerequisites

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

Related documentation

Message Billing Number History Template Type Delivered

Endpoint: GET /api/v2/billing/summary. Returns totals using the same filters as message billing history.

GET/api/v2/billing/summary

Parameter	Type	Required	Description
`senderId`	string	Optional	Optional WhatsApp sender phone number.
`phoneNumberId`	string	Optional	Optional Meta phone number id filter.
`dateFrom`	string	Optional	YYYY-MM-DD start date.
`dateTo`	string	Optional	YYYY-MM-DD end date.
`templateType`	string	Optional	Meta pricing category filter.
`billable`	string	Optional	true, false, payable, or free.

Billing summary

curl "https://graph.whats91.com/api/v2/billing/summary?dateFrom=2026-06-01&dateTo=2026-06-30" \
  -H "Authorization: Bearer w91_live_xxx"

Billing summary response

{
  "success": true,
  "message": "Billing summary retrieved",
  "data": {
    "scope": "user",
    "summary": {
      "totalRecords": 100,
      "deliveredRecords": 91,
      "payableRecords": 80,
      "freeRecords": 20,
      "payableAmount": 92.5,
      "categoryBreakdown": [
        {
          "templateType": "utility",
          "pricingCategory": "utility",
          "totalRecords": 60,
          "deliveredRecords": 56,
          "payableRecords": 50,
          "freeRecords": 10,
          "payableAmount": 40
        }
      ]
    }
  }
}

SDK Examples

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

cURL

curl -X GET "https://graph.whats91.com/api/v2/billing/summary" \
  -H "Authorization: Bearer w91_live_xxx"

Node.js

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

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

Related APIs

Message Billing

Read user-wide message billing records across WhatsApp sender numbers.

Number History

Read message billing records for one WhatsApp registered number.

Template Type

Read billing records filtered by Meta pricing category.

Delivered

List delivered billing records through the delivered convenience endpoint.