# GET /suppressions

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

List every address the platform will refuse to send to, with the reason, the source and the timestamp.

```http
GET https://api.sendheron.com/api/v1/suppressions
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `suppressions:read`

**Success status:** `200`

**Rate limit:** 100/min per key, counted against the organization's READ ceiling (1200/min).

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Zero-indexed page number. Defaults to `0`. |
| `limit` | integer | no | Items per page. |
| `email` | string | no | Partial match on the address. |
| `tier` | HARD | CONSENT | no | `HARD` is a bounce or a complaint and blocks every channel including transactional. `CONSENT` is an opt-out and blocks marketing only. |
| `reason` | string | no | One of `manual`, `one_click`, `complaint`, `bounce`, `admin`. |
| `source` | string | no | Who put it there: `PROVIDER_WEBHOOK`, `RECIPIENT`, `DASHBOARD`, `API` or `SYSTEM`. Distinct from the reason, which is why we will not send. |

> Consent suppressions belong to one workspace, because an unsubscribe from one product is not an unsubscribe from another. Hard suppressions are stored account-wide, so one project's bounced list cannot burn a sibling project's sending reputation.


---

Rate limits: 100/min per key, counted against the organization's READ ceiling (1200/min). Both windows are one minute; there is no hourly or daily quota.