List suppressions

List and search suppressed email addresses. Returns up to 1000 suppressions per request. Use last_id for cursor-based pagination through large lists.

Suppressed addresses will not receive any emails from your account.

Rate limit: 10 requests per minute per account.

get

Authorizations

Api-TokenstringRequired

API token in Api-Token header

Query parameters

emailstring · emailOptional

Filter suppressions by exact email address (case-insensitive).

Example: [e-mail]

start_timestring · date-timeOptional

Filter suppressions created at or after this timestamp (ISO 8601 format).

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

end_timestring · date-timeOptional

Filter suppressions created at or before this timestamp (ISO 8601 format).

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

last_idstring · uuidOptional

The suppression UUID from the last record of the previous response. Returns records after this suppression, enabling cursor-based pagination through large lists.

Example: 64d71bf3-1276-417b-86e1-8e66f138acfe

Responses

200

List of suppressions

application/json

idstring · uuidOptional

The suppression UUID

Example: 64d71bf3-1276-417b-86e1-8e66f138acfe

typestring · enumOptional

Reason for the suppression

Example: hard bouncePossible values:

created_atstring · date-timeOptionalExample: 2025-01-15T10:30:00Z

emailstring · emailOptionalExample: [e-mail]

sending_streamstring · enumOptionalExample: transactionalPossible values:

domain_namestring · nullableOptionalExample: example.com

message_bounce_categorystring · nullableOptional

message_categorystring · nullableOptional

message_client_ipstring · nullableOptional

message_created_atstring · nullableOptional

message_esp_responsestring · nullableOptional

message_esp_server_typestring · nullableOptional

message_outgoing_ipstring · nullableOptional

message_recipient_mx_namestring · nullableOptional

message_sender_emailstring · nullableOptional

message_subjectstring · nullableOptional

400

Bad request - invalid parameters.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

get/api/suppressions

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

# Search for specific email
curl -X GET 'https://mailtrap.io/api/suppressions?email=[e-mail]' \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": "64d71bf3-1276-417b-86e1-8e66f138acfe",
    "type": "hard bounce",
    "created_at": "2025-01-15T10:30:00Z",
    "email": "[e-mail]",
    "sending_stream": "transactional",
    "domain_name": "example.com",
    "message_bounce_category": null,
    "message_category": null,
    "message_client_ip": null,
    "message_created_at": null,
    "message_esp_response": null,
    "message_esp_server_type": null,
    "message_outgoing_ip": null,
    "message_recipient_mx_name": null,
    "message_sender_email": null,
    "message_subject": null
  }
]