Plan, messages used and left, limits, what WhatsApp charges
https://api.app2email.com/v1/{number}/usage WhatsApp messages used and left this billing month, the billing period, the most numbers per send request, your own monthly cap, and meta_pricing: the month's messages by Meta's pricing category with an indicative cost.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270
Responses
Fields
- success boolean
- request_id string
- number string
- plan stringe.g.
standard_5000 - service_status stringe.g.
LIVE - billing_period object
- whatsapp_messages object
used: WhatsApp messages sent. limit and left: the plan's, shared with outgoing email - see plan_messages.
- plan_messages object
The plan limit covers outgoing WhatsApp + outgoing emails added together.
5 fields
- whatsapp_sent integer
- emails_sent integer
- total_sent integer
- limit integer
- left integer
- max_numbers_per_request integer
- broadcasts_this_billing_month integer
- do_not_call_list object
1 fields
- count integer
- webhooks integer
- monthly_cap integer
The number's own monthly cap (settings caps.monthly_messages). Left out when there is none.
- meta_pricing object
What WhatsApp (Meta) charges for the billing month's messages, from the pricing object of its status webhooks. Indicative: Meta bills you directly.
6 fields
- billing_period object
- counts object
9 fields
- service_free_used integer
- service_billable integer
- utility integer
- marketing integer
- authentication integer
- free_entry_point integer
- unknown integer
No pricing information (yet).
- total integer
- estimated_cost_usd number
- free_service_messages object
4 fields
- allowance_per_month integere.g.
1000 - used integer
- left integer
- note string
- estimated_cost object
7 fields
- currency stringe.g.
USD - amount number
- rate_region string
- rate_region_code string
- rates_last_checked string
- note string
- days object[]
GET /usage/meta only: per day.
2 item fields
- date stringe.g.
2026-11-02 - counts objectFields: as meta_pricing.counts
- note string
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.
- 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.