List suppressed addresses
GET/api/v1/suppressions
curl -X GET 'https://www.unitpost.com/api/v1/suppressions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'{
"object": "list",
"has_more": false,
"data": [
{
"object": "suppression",
"id": "id_123",
"email": "customer@example.com",
"scope": "workspace",
"reason": "bounce",
"detail": "string",
"note": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
]
}Retrieve a list of the email addresses your workspace has suppressed, newest-first and cursor-paginated. The list holds your workspace's own suppressions only. Unitpost-wide (platform) blocks are enforced at send time but never listed: they appear as email.suppressed on the send they stopped, and Retrieve a suppressed address with an email address still returns one, so you can see why that address is blocked. (Since 2026-10-13; before that the list also included platform rows.) Add an address with Suppress an address or lift a block with Un-suppress an address. Narrow the list with q, reason and a created_after / created_before range. A filter value it can't apply (a typo, an unknown id) is ignored and named in the Unitpost-Warning header, and the answer is the one without it; send Unitpost-Strict: true to have it refused instead. Requires the suppressions:read capability.
Parameters8 fields
| Field | Type | Description |
|---|---|---|
limit | integer · query | Max rows to return (default 20, max 100). |
after | string · query | Return rows after this id (forward paging). |
before | string · query | Return rows before this id (backward paging). |
q | string · query | Part of the email address (case-insensitive). At most 200 characters. |
reason | string · query | Only suppressions with this reason. |
created_after | string · query | Only suppressions created at or after this time. ISO 8601 with `Z` or a `±hh:mm` offset; normalized to UTC (reads return the UTC time). |
created_before | string · query | Only suppressions created before this time. ISO 8601 with `Z` or a `±hh:mm` offset; normalized to UTC (reads return the UTC time). |
scope | string · query | Deprecated and ignored (2026-10-13). The list always returns your workspace's own suppressions; platform rows are never listed. Still accepted so existing callers don't break. |
Response · 200 fields9 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
idrequired | string | — |
emailrequired | string | — |
scoperequired | enumworkspace | platform | — |
reasonrequired | enumbounce | complaint | unsubscribe | manual | import | api | — |
detailrequired | string | null | — |
noterequired | string | null | — |
created_atrequired | string | — |
updated_atrequired | string | — |