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

cURLNode.jsPHPPythonRuby.NETJava

# Get all suppressions
curl -X GET https://mailtrap.io/api/accounts/{account_id}/suppressions \
  -H 'Authorization: Bearer YOUR_API_KEY'

# Search for specific email
curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/[email protected]' \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": 1,
    "email": "[email protected]",
    "reason": "bounce",
    "created_at": "2026-02-05T13:53:05.900Z"
  }
]

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}

cURLNode.jsPHPPythonRuby.NETJava

curl -X DELETE https://mailtrap.io/api/accounts/{account_id}/suppressions/{suppression_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

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