Suppressions

Manage suppressed email addresses

Control which email addresses should not receive emails from your account.

List suppressions

get

List and search suppressed email addresses. Returns up to 1000 suppressions per request.

Suppressed emails will not receive any emails from your account.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

Query parameters

emailstring · emailOptional

Search for specific email address

Example: [email protected]

Responses

200

List of suppressions

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

get

/api/accounts/{account_id}/suppressions

Node.jsPHPPythonRuby.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

// Get all suppressions
const suppressions = await client.suppressions.getList();

// Or search for specific email
const filtered = await client.suppressions.getList({
  email: "[email protected]"
});

console.log("Suppressions:", suppressions);

[
  {
    "id": 1,
    "email": "[email protected]",
    "reason": "bounce",
    "created_at": "2025-12-30T13:20:37.304Z"
  }
]

Delete suppression

delete

Remove an email from the suppression list to allow sending again

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

suppression_idintegerRequired

Suppression ID

Example: 1

Responses

200

Suppression deleted

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

404

Resource not found

application/json

delete

/api/accounts/{account_id}/suppressions/{suppression_id}

Node.jsPHPPythonRuby.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const suppressionId = "abc123-def456";
const result = await client.suppressions.delete(suppressionId);

console.log("Suppression removed:", result);

{
  "success": true,
  "message": "Suppression removed successfully"
}