Get outbound WhatsApp statistics by country

Returns delivery counts, read engagement and latency grouped by the recipient's destination country. Rows use send-time attribution, rank by accepted volume, and are capped by limit (default 50, maximum 200). A recent period under-reports delivered while delivery reports are still arriving. The maximum window is 365 days; a longer range returns 422.

A country row covers messages addressed to a single recipient. A recipient whose country cannot be resolved (a number shaped like a phone number that belongs to no country, or a non-geographic range such as freephone) is counted under ZZ rather than dropped, matching the SMS country breakdown. Group sends are omitted entirely: one spans up to eight recipients in as many countries, so no single destination country describes it. These rows therefore sum to the summary less that group volume. A window reaching before this breakdown shipped falls short by more than that: history was seeded only where the recipient's country could be recovered from stored data, so a phone-addressed send accepted before the cutover has no accepted leg here. Two cases follow, and they read differently. Acceptance days more than 14 days before the cutover are a plain shortfall and never change. In the 14 days immediately before it, a delivered, read or failed callback arriving after the cutover does carry a country and is attributed to its original acceptance day, so a row there can report deliveries with accepted at zero. Its delivery_rate and failure_rate are then null for want of a denominator while read_rate still computes and looks healthy. The 14 days are the status recording window, after which a callback is dropped. All of this is confined to pre-cutover acceptance days and gone once the requested window starts after the cutover date.

Latency reports the same three families as the summary: processing, delivery and total. The delivery family depends on a best-effort handoff timestamp that a fast delivery callback can beat, so it can be absent for a country whose other two families are present.

A breakdown is already a single-dimension view and takes no dimension filter; to restrict statistics to a single template, category, phone number or tag, use the summary, daily or hourly statistics instead.