Read the active classification rules for the calling org
Returns the active rule set the /v1/undeliverable surface applies
when classifying recipients (SND-713). Three rules are always-on
(locked, cannot be disabled): permanent_bounce, complaint,
rejected. Three rules are configurable per org, each with an
events threshold (N) and window_days (M) — an address matches
when ≥ N qualifying events have occurred in a rolling M-day window.
When an address matches multiple rules, the wire reason is the
highest-priority match in this order:
permanent_bounce > complaint > rejected > repeated_transient >
undetermined > soft_bounce_accumulation.
Rules are read-only over the public API in v1 — changes are made
through the dashboard (audit-logged, granted to owners + admins
only). Callers should pin against version and re-fetch when the
X-SendOps-Rules-Version header on /v1/undeliverable changes.
Responses
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json