Message volume and delivery by destination country
Breaks the tenant’s messaging traffic for the selected date range down by destination country, returning total sent, delivered and failed plus the delivery rate per country so operators can spot a country where delivery is degrading. Optionally filter to a single channel. Read-only; degrades to an empty countries array (still 200) during a transient database blip so the continuously-polled insights widget never surfaces a 5xx.
Authorizations
Dashboard JWT token from Clerk
Query Parameters
Inclusive start of the reporting window (ISO-8601 date, e.g. 2026-07-01). Defaults to the tenant's standard lookback when omitted; the range may not exceed the platform lookback cap.
Inclusive end of the reporting window (ISO-8601 date). A single-day range (start_date === end_date) is accepted.
Alternative rolling lookback in whole days (bounded by the lookback cap). Mutually exclusive with an explicit start/end range.
x >= 1Optional single-channel filter (e.g. sms, whatsapp, email).