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, emails to that address are rejected at the SMTP level (550 5.1.1) before reaching the mail provider.

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

Check Suppression

GET /suppression/check/{email}

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

Response

Field	Type	Description
`email`	string	The email address checked
`suppressed`	boolean	Whether the address is suppressed
`reasons`	string[]	Why it was suppressed: `bounce`, `complaint`, or both

Example

curl https://api.emboux.com/suppression/check/[email protected] \
  -H "Authorization: Bearer {API_KEY}"

{
  "email": "[email protected]",
  "suppressed": true,
  "reasons": ["bounce"]
}

List Suppressions

GET /suppression

List suppression entries with optional filters. Master token required.

Query Parameters

Parameter	Type	Description
`domain`	string	Filter by source domain (the domain that triggered the suppression)
`reason`	string	Filter by reason: `bounce` or `complaint`
`limit`	integer	Max entries to return (default: 100)
`offset`	integer	Pagination offset (default: 0)

Response

Field	Type	Description
`entries`	object[]	List of suppression entries
`count`	integer	Number of entries returned

Each entry:

Field	Type	Description
`id`	integer	Entry ID
`email`	string	Suppressed email address
`reason`	string	`bounce` or `complaint`
`source_domain`	string	Domain that caused the suppression
`provider`	string	Provider that reported it (`ses`, `mailgun`)
`created_at`	string	ISO timestamp

Example

curl "https://api.emboux.com/suppression?domain=example.com&reason=bounce&limit=10" \
  -H "Authorization: Bearer {MASTER_TOKEN}"

Remove Suppression

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).

Response

Field	Type	Description
`email`	string	The email address removed
`removed`	integer	Number of entries deleted (0 if not found)

Example

curl -X DELETE https://api.emboux.com/suppression/[email protected] \
  -H "Authorization: Bearer {MASTER_TOKEN}"