Get message usage

GET 
/api/v1/accounts/:accountId/usage/messages

Returns monthly per-message usage totals for the specified billing period. Results can be filtered and grouped by subaccount, business account, channel, pricing category, and destination country.

Currently, only WhatsApp is supported.

Constraints:

• Data is available from February 2026 onwards
• Only closed billing periods can be queried
• Maximum lookback: 6 months

Grouping behavior:

• If groupBy is omitted, a single aggregated total is returned
• pricing is included when groupBy contains channel, businessAccountId, pricingCategory, and country

Request

Responses

200

Successful response containing message usage data.

400

Bad request. The billing period format is invalid, the period is not yet closed, the date is before February 2026, or the lookback exceeds 6 months.

401

Request was not authenticated.