# List suppressions

### List suppressions

`GET /api/v1/suppressions`

Operation ID: `listSuppressions`

**Query parameters**

- `cursor` (string, optional)
- `limit` (integer, optional)
- `reason` ("manual" | "unsubscribed" | "not_interested" | "existing_customer" | "open_opportunity" | "competitor" | "employee" | "invalid_recipient" | "complained" | "recently_contacted" | "unresponsive", optional)

**200**: A page of suppression entries, newest first. Pass nextCursor as cursor for the next page.

- `suppressions` (object[], required)
- `nextCursor` (string | null, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload