What WhatsApp cost this account, and on what

GET 
/api/channels/:channel/whatsapp/insights

Meta's own conversation_analytics and pricing_analytics for the channel's WhatsApp Business Account, aggregated into totals, per-category breakdowns and a trend series. Read-only and admin-gated (Channel view).

NOT an accounting source: Meta states its analytics are approximate and may differ from the invoice, so nothing here feeds billing.

Meta buckets days in the WABA's OWN timezone, so timezone_id travels with the numbers — a daily figure read under a different clock will not match WhatsApp Manager. The window defaults to the last 30 days and a start older than Meta's one-year lookback is clamped rather than refused.

template_analytics is deliberately absent: it needs an IRREVERSIBLE is_enabled_for_insights opt-in that consents, on the tenant's behalf, to Meta collecting from their customers' chats. That is a consent decision and gets its own screen.

Request

Responses

200

The consumption snapshot.

422

Meta could not produce the report. code says which kind: whatsapp_insights_permission — Meta refused because this app has not been granted access to the account's analytics (Graph 10, 2xx, or a scope-bound 190); nothing is broken and the data appears once Meta grants it. whatsapp_insights_unavailable — any other failure.