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 addresses 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]

start_timestring · date-timeOptional

Search emails suppressed after this timestamp

Example: 2025-01-01T00:00:00Z

end_timestring · date-timeOptional

Search emails suppressed after this timestamp

Example: 2025-12-31T23:59:59Z

Responses

200

List of suppressions

application/json

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

429

Rate limit exceeded for the current account.

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
});

async function getSuppressions() {
  // 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);
}

getSuppressions();

[
  {
    "id": 1,
    "email": "[email protected]",
    "reason": "bounce",
    "created_at": "2026-01-20T12:45:43.103Z"
  }
]

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
});

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

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

deleteSuppression();

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