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.
Check Suppression
Section titled “Check Suppression”GET /suppression/check/{email}Check if a specific email address is on the suppression list.
Response
Section titled “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
Section titled “Example” -H "Authorization: Bearer {API_KEY}"{ "suppressed": true, "reasons": ["bounce"]}List Suppressions
Section titled “List Suppressions”GET /suppressionList suppression entries with optional filters. Master token required.
Query Parameters
Section titled “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
Section titled “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
Section titled “Example”curl "https://api.emboux.com/suppression?domain=example.com&reason=bounce&limit=10" \ -H "Authorization: Bearer {MASTER_TOKEN}"Remove Suppression
Section titled “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
Section titled “Response”| Field | Type | Description |
|---|---|---|
email | string | The email address removed |
removed | integer | Number of entries deleted (0 if not found) |
Example
Section titled “Example” -H "Authorization: Bearer {MASTER_TOKEN}"