Skip to content

Suppression List

The suppression list is a global blocklist of recipient email addresses that have previously generated a bounce or complaint on any domain in the platform. When a recipient is on this list and the sending domain is in hard enforcement mode, emails to that address are rejected at the SMTP level (550 5.1.1) before reaching the mail provider. In soft mode the suppression is only recorded; the email is not rejected.

This protects your sending reputation proactively — you don’t pay for emails that would bounce anyway.


GET /suppression/check/{email}

Check if a specific email address is on the suppression list.

FieldTypeDescription
emailstringThe email address checked
suppressedbooleanWhether the address is suppressed
reasonsstring[]Why it was suppressed: bounce, complaint, or both
Terminal window
curl https://api.emboux.com/suppression/check/[email protected] \
-H "Authorization: Bearer {API_KEY}"
{
"email": "[email protected]",
"suppressed": true,
"reasons": ["bounce"]
}

GET /suppression

List suppression entries with optional filters. Master token required.

ParameterTypeDescription
domainstringFilter by source domain (the domain that triggered the suppression)
reasonstringFilter by reason: bounce or complaint
limitintegerMax entries to return (default: 100)
offsetintegerPagination offset (default: 0)
FieldTypeDescription
entriesobject[]List of suppression entries
countintegerNumber of entries returned

Each entry:

FieldTypeDescription
idintegerEntry ID
emailstringSuppressed email address
reasonstringbounce or complaint
source_domainstringDomain that caused the suppression
providerstringProvider that reported it (ses, mailgun)
created_atstringISO timestamp
Terminal window
curl "https://api.emboux.com/suppression?domain=example.com&reason=bounce&limit=10" \
-H "Authorization: Bearer {MASTER_TOKEN}"

DELETE /suppression/{email}

Remove an email address from the suppression list. Master token required.

Use this when you’ve confirmed that a previously bounced address is now valid (e.g., the recipient fixed their mailbox).

FieldTypeDescription
emailstringThe email address removed
removedintegerNumber of entries deleted (0 if not found)
Terminal window
curl -X DELETE https://api.emboux.com/suppression/[email protected] \
-H "Authorization: Bearer {MASTER_TOKEN}"