Message counts, delivery and read rates for a period
https://api.app2email.com/v1/{number}/stats For a time range (default the last 30 days, at most 366 days). The same counts as a broadcast report.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270
Query
- from string (date-time)
Start of the range. ISO 8601.
e.g.2026-09-26T00:00:00Z - to string (date-time)
End of the range. ISO 8601.
e.g.2026-10-26T00:00:00Z
Responses
Fields
- success boolean
- request_id string
- from string (date-time)
- to string (date-time)
- messages object
Sent messages in the range: submitted, accepted (WhatsApp took them), sent, delivered, read, failed, replied.
- received integer
- rates object
Fractions: delivery = delivered / sent, read = read / delivered, reply = replied / sent.
- truncated boolean
true: the range had too many messages, the counts are for part of it.
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.
- 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.