WhatsApp spend
What Meta billed the business for WhatsApp on one channel, by category and country, in Meta's currency.
Meta bills the business directly for WhatsApp; Blueticked never resells or meters it. This is Meta's own pricing analytics for the channel's WhatsApp Business Account, so currency is the currency Meta bills in, and the figures are approximate until Meta's billing settles.
days is a whole number from 1 to 90 (default 30); the window ends now. Anything else is 400 validation_failed.
cost is what Meta charged: 0 for free messages (a customer-service reply, for one), and null only where Meta reports messages without a cost. Lines are ordered by cost, highest first.
An id that is not a UUID is 400 validation_failed. A channel that is not WhatsApp is 400 validation_failed with details.reason "not_whatsapp_channel"; one with no Meta connection, or whose token Meta refuses, is 503 channel_unavailable ("whatsapp_token_missing": reconnect it, retrying will not help). When Meta fails or cannot be reached the answer is 502 provider_error or 503 service_unavailable ("meta_unavailable"), never an empty spend.
Each channel can be read 30 times a minute, whichever key asks; a key confined to other businesses gets 404 not_found, as for another workspace's channel.
Request
- Base URL: https://app.blueticked.com
- URL: https://app.blueticked.com/api/v1/channels/{id}/whatsapp-spend
- Auth: HTTP bearer
Path parameters
The resource's unique identifier.
Query parameters
The window in whole days, ending now: 1 to 90, default 30.
Response
Success
Example response
{
"channel_id": "1891a644-c71d-4a79-b679-6db1db14e065",
"window": {
"days": 30,
"start": "2026-09-18T09:00:00.000Z",
"end": "2026-10-18T09:00:00.000Z"
},
"totals": {
"messages": 1240
},
"by_category": [
{
"category": "marketing",
"messages": 820
}
],
"by_country": [
{
"country": "ZA",
"messages": 1180
}
],
"request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}Changes
No recorded changes to this operation across all 1 revision of this API.