Get Messages
Returns an organization’s WhatsApp message analytics: summary cards at the top and a time series below.
The source is ClickHouse with no caching, so every request returns the most up-to-date data. Scope it org-wide (all apps) or to selected apps, and bucket it by a date range and a granularity.
Invariants. Σ series[].sentMessages == summary.sentMessages, and the same holds for templateMessages and receivedMessages. templateMessages never exceeds sentMessages.
Authorizations
Secret key in Bearer sk_... format. Server-to-server only — never embed it in a browser or mobile client. The organization is resolved from the key, so organization_id is never passed explicitly.
Query Parameters
Repeatable. Omit to include every app in the organization, or repeat it (?appId=app_AAA&appId=app_BBB) to scope to specific apps. An ID that does not belong to the organization returns 404.
ISO-8601 datetime. Start of the range. Defaults to today 00:00:00 UTC.
"2026-06-01T00:00:00"
ISO-8601 datetime. End of the range; must be greater than startDate. Defaults to today 23:59:59 UTC.
"2026-06-08T00:00:00"
How the series is bucketed. Any other value returns 422.
hourly, daily, weekly, monthly