Messaging insights — carrier, country, and error breakdowns
Returns three histograms plus a totals roll-up for one channel over a window: per-carrier sent/delivered/failed with delivery + failure rates, per-country counters resolved from the message network identity, and per-error-code counts decorated with a human-readable name/description/category — plus a failure-category roll-up so you can see at a glance whether carrier filtering, content, or opt-outs dominate. Query params: channel (sms|whatsapp|rcs|email|viber|push|messenger|telegram), window (24h|7d|30d), and optional carrier / country / errorCode drill-downs; each dimension capped at the top 25 buckets. Owner/admin only — the carrier-side filtering signal is withheld from viewer scope. Read-only, 60s cached.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Response
Successful response.