MepMail Docs
API referenceEndpointsSuppressions

List suppressions

GET
/suppressions

Lists suppressed addresses, optionally by origin.

AuthorizationBearer <token>

An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.

In: header

Query Parameters

limit?integer

Page size, 1-100 (default 20)

Range1 <= value <= 100
after?string

Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.

Formatuuid
before?string

Cursor: id of the first item of the next page (page backwards); same rule as after.

Formatuuid
origin?string

Only suppressions of this origin: bounce, complaint, manual or unsubscribe

Value in

  • "bounce"
  • "complaint"
  • "manual"
  • "unsubscribe"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/suppressions"
{  "object": "list",  "data": [    {      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",      "email": "customer@example.com",      "origin": "bounce",      "source_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",      "created_at": "2026-10-19T12:00:00.000Z"    }  ],  "has_more": false}