Skip to content

Suppressions

Manage system-level suppressions for bounces and spam complaints.

Suppression Types:

  • Hard Bounces: Permanent delivery failures (automatically added by the system)
  • Soft Bounces: Temporary delivery failures (automatically added after threshold)
  • Complaints: Spam complaints and feedback loop reports

Suppression Scope:

  • Global: Applies to ALL your domains (when no domain_id specified)
  • Domain-specific: Applies to a specific domain only

Key Features:

  • Automatic bounce and complaint handling
  • Whitelist management to override suppressions
  • List all suppressions with filtering
  • Manual suppression management

Automated list hygiene to protect your sender reputation and ensure compliance.

Operations

List all suppressions

Request

Retrieve all system-managed suppressions (hard bounces, soft bounces, and spam complaints) with filtering capabilities.

Use this to:

  • Monitor bounce and complaint trends
  • Export comprehensive suppression lists
  • Filter by type, domain, or date range
  • Track suppression sources and reasons
  • Manage whitelist overrides

Suppression Types:

  • bounce: Hard and soft bounces (added automatically by the system)
  • complaint: Spam complaints and feedback loop reports (added automatically)

Each suppression includes a scope field indicating whether it's global (all domains) or domain-specific.

Note: For user opt-outs and unsubscribes, see the /api/v1/customer/unsubscribes endpoints.

Security
ApiKeyAuth
Query
pageinteger, >= 1
Default:1
limitinteger, [ 1 .. 100 ]
Default:50
searchstring

Search by email address (partial match)

typestring

Filter by suppression type

Enum:"bounce""complaint""unsubscribe"
domain_idstring, (uuid)

Filter by specific domain

from_datestring, (date)

Filter from date (YYYY-MM-DD)

to_datestring, (date)

Filter to date (YYYY-MM-DD)

curl -i -X GET \
  'https://api.mailerlogic.net/api/customer/suppressions?page=1&limit=50&search=string&type=bounce&domain_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&from_date=2019-08-24&to_date=2019-08-24' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Suppressions retrieved successfully

Bodyapplication/json
suppressionsArray of objects
countsobject
paginationobject(Pagination)
Response
{
  "suppressions": [
    { … },
    { … }
  ],
  "counts": {
    "bounce": 15,
    "complaint": 3,
    "unsubscribe": 42
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 60,
    "pages": 2
  }
}