Top carrier rejection codes for a funnel drop-off step
Root-cause drill-down for a delivery-funnel step: returns the leading carrier/provider rejection codes behind messages that dropped at the named step, each enriched with a human-readable name, an actionable description and a category from the carrier error dictionary, plus its count and share of drops. Use it to answer ‘why did messages fail to deliver at this stage?’ from the funnel chart. The sent step (sent-but-never-delivered) is populated today; the other steps are reserved and return an empty reasons array. Read-only; degrades to an empty reasons list (still 200) during a transient database blip.
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Funnel stage to explain. sent returns rejection codes for messages that were sent but never delivered; other steps are reserved and return an empty list.
sent, delivered, read, queued Query Parameters
Inclusive start of the reporting window (ISO-8601 date or datetime). Defaults to the last 30 days when omitted.
Inclusive end of the reporting window (ISO-8601 date or datetime).
Alternative rolling lookback in whole days. Mutually exclusive with an explicit start/end range.
x >= 1Optional single-channel filter (e.g. sms, whatsapp, email).
Maximum number of error codes to return.
1 <= x <= 20