Skip to content

suppressed

The email address, phone number or postal address is on your account's suppression list

Batch runs, bulk jobs and monitors answered it from your suppression list without running a lookup. Email, phone and postal address each keep their own list, all three per account. Phone and postal entries with no stored answer answer valid false with this reason.

appears in
reason
verdict
undeliverable
credits
Free. Suppressed answers are served from the list, with the stored answer where there is one, without running the pipeline.

What it means

Your email suppression list holds every address a verdict found undeliverable until a later verdict or a reported delivery clears it, the addresses your own bounce and complaint reports added, and anything you imported. The phone list holds numbers in blocks the regulator does not allocate, numbers your own SMS outcomes wrote off (reason undelivered or abuse), numbers whose recipient opted out (reason opted_out, from your own report or your SMS provider's opt-out code), and imports. The postal list holds addresses your own delivery reports wrote off — the occupant has moved, delivery was refused, or post came back twice with no delivery since — and imports. Batch, bulk and monitor runs consult the list first and answer from the stored result: reason suppressed for entries with no stored answer, the original reason for verified ones, and meta.suppressed true either way. An import that kept a verified answer from before you imported it serves that answer for 90 days after the entry was last renewed, then answers reason suppressed, because nothing looks an import up again.

Single lookups through the API and the dashboard deliberately ignore the list. For email, a recovered verdict removes only an entry a verdict added and a fresh undeliverable one renews any entry, while an import stays until you remove it, a bounce your reports added until a delivery to that address is reported, and a complaint, like a phone opt-out, until you remove it — it never goes stale, and a complaint about an address you imported is recorded on the import, which stays an import. For a postal address, a lookup drops an entry your reports added once the reports behind it have aged out or a delivery was reported since, and never touches an import. A phone lookup clears only an entry an unassigned block added, because a numbering-plan valid says nothing about your own outcomes or a recipient's opt-out. Imports, complaints, opt-outs and abuse reports never go stale: batch, bulk and monitor runs serve them for as long as they are listed. Any other entry older than 90 days is looked up afresh rather than trusted.

A phone opt-out is a consent fact, not a verdict on the number, so it never raises the risk score and never goes stale: no lookup, delivery or entered code clears it, only removing the entry does. An opt-out or abuse report about a number you imported is recorded on that entry, which stays an import. A single phone lookup answers and scores the number in full and says meta.opted_out true, and under the default SMS policy it answers ok_to_send false with blocked_by opted_out (an account that sends one-time codes may switch block_opted_out off); batch, bulk and monitor runs serve it suppressed. Honouring an opt-out stays your obligation — the list is your own record, not a consent system.

Postal suppression is yours alone. Nothing you report about an address is ever read for another account: a shared "post fails here" database would be a database about residences, and this product does not build one.

What to do

Nothing for sends: it stays out. To challenge an email entry a verdict added, look that one address up on its own; the fresh answer replaces or clears it. A postal entry your reports added leaves when you report a delivery, or at the next single lookup once those reports have aged out. An import on any of the three lists leaves only when you remove it, and importing an entry that is already listed makes it an import; an email bounce your reports added leaves when a delivery to it is reported, and an email complaint only when you remove it. A phone entry leaves its own way: a lookup clears only an entry an unassigned block added, an undelivered entry leaves on a later delivered or verified report, and an abuse entry, an import or an opt-out only when you remove it; an abuse or opt-out entry you removed comes back only with a new abuse report or opt-out. Any entry can be removed through the suppression endpoints.

Example response

{
    "email": "[email protected]",
    "deliverable": "undeliverable",
    "reason": "suppressed",
    "risk_score": 100
}

Abbreviated: a real answer carries all 46 fields, listed in the verify-email reference.

Related

markdown version: /docs/reasons/suppressed.md