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