`list_suppressions`

Lists the project’s suppressions by address, then scope, at most 100 per call, or those of one address (email).

Call it: to see why an address gets no mail, or to page through the suppression list.
Needs: an admin key with project_id, or a project key with scope read (its own project; the argument is ignored).
Returns: items and next_cursor: pass it as cursor for the next page; null on the last page. The same as GET /api/v1/projects/{project_id}/suppressions.

Arguments

object
cursorstring | null

next_cursor of the previous page; leave it out for the first.
emailstring | null

Only this address; left out: every address.

example ann@example.com
limitinteger · int64 | null

Page size, 1 to 100; default 50.

1–100
project_idstring · uuid | null

The project. An admin key must pass it; a project key’s own project is used and this is ignored.

No other arguments are accepted.

The result comes back as structuredContent, with the same JSON as a text block.

object · all fields required
itemsarray of Suppression

By address, then by scope.
6 fields
- Suppression object · all fields required
- created_atstring · date-time
- emailstring · email
- project_idstring · uuid
  
  The suppression’s project.
- reasonstring
  
  unsubscribed_all, unsubscribed_list, hard_bounce, soft_bounce_limit, complaint or manual.
- scopestring
  
  project (every list) or list:<list_id>.
- sourcestring
  
  Where it came from: api (the API or MCP), web, delivery or inbound.
next_cursorstring | null

Pass as cursor for the next page; null on the last page.

An address on the project’s suppression list (GET /api/v1/projects/{project_id}/suppressions, an item).

object · all fields required
created_atstring · date-time
emailstring · email
project_idstring · uuid

The suppression’s project.
reasonstring

unsubscribed_all, unsubscribed_list, hard_bounce, soft_bounce_limit, complaint or manual.
scopestring

project (every list) or list:<list_id>.
sourcestring

Where it came from: api (the API or MCP), web, delivery or inbound.

A failed call answers isError: true with a code from the same table as the HTTP API, and detail. How tools report errors