WhatsApp cost and volume of this number
https://api.app2email.com/v1/{number}/analytics/pricing Meta's pricing_analytics for this number: delivered messages and their cost per period. Estimates, not the invoice.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270
Query
- since string (date-time)
Start, ISO 8601. Default: 30 days before until. At most 1 year back.
e.g.2026-10-01T00:00:00Z - until string (date-time)
End, ISO 8601. Default: now.
e.g.2026-11-01T00:00:00Z -
Default day.
half_hourdaymonth - countries string
Only these countries: comma separated 2-letter codes.
e.g.DE,AT - dimensions string
Break down by: comma separated category, type, country, tier, phone. Default category,type.
e.g.category,type,country
Responses
Fields
- e.g.
true - e.g.
a1n2l - since string (date-time)
- until string (date-time)
- granularity string
- currency string
-
9 item fields
- start string (date-time)
- end string (date-time)
- pricing_category string
MARKETING, UTILITY, AUTHENTICATION, AUTHENTICATION_INTERNATIONAL, MARKETING_LITE, SERVICE, REFERRAL_CONVERSION.
- pricing_type string
REGULAR, FREE_CUSTOMER_SERVICE, FREE_ENTRY_POINT.
- country string
- tier string
Volume tier, eg 0:750000 (with dimensions tier).
- phone_number string
- volume integer
- cost number
In the WhatsApp Business Account's currency. Not given when the account uses a partner's credit line.
- totals object
Errors
- 400 The request is malformed (missing or invalid fields, query parameters or times).
- 401 Missing, invalid, revoked or expired API key.
- 403 The key is valid but this call is not allowed: the key lacks the scope the call needs (insufficient_scope), the address is not allowed for the key (ip_not_allowed), the number or plan does not allow it, a recipient opted out or is not opted in, or a problem with the WhatsApp account.
- 404 The number, template, message, broadcast, webhook, delivery, opt-in, logged request, booking or Flow was not found.
- 422 The request is understood but cannot be sent (template parameters, media, text, recipient, or a WhatsApp rule such as the 24 hour window).
- 429 A monthly plan limit, the number's own monthly cap, the key's daily cap, a WhatsApp rate limit, the API rate limit (rate_limited), or the webhook test limit (too_many_tests) was reached. Retry-After and error.retry_after_seconds say how long to wait.
- 500 Unexpected error on app2email's side.
- 502 WhatsApp (Meta) returned an error or could not be reached.
- 503 app2email's connection to the WhatsApp account needs attention, or the request log is not available right now.