---
title: "List suppressions"
method: GET
path: "/suppressions"
tags: ["Suppressions"]
---

# List suppressions

`GET /suppressions`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/suppressions`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `email` string, email
- `q` string
- `status` 'bounce' | 'complaint' | 'manual' | 'api' | 'unsubscribe' | 'import' | 'verification': How the address was suppressed: `bounce` and `complaint` from delivery feedback, `unsubscribe` when the recipient unsubscribed, `import` from an uploaded suppression list, `verification` when the address was checked before a campaign's first send to it and the mailbox does not exist or is a disposable inbox, and `api` or `manual` when you added it yourself (`POST /suppressions` records `api`).

## Response `200`

Suppression list

- ListSuppressionsResponse
  - `data` Suppression[], required
    - `id` string, required
    - `email` string, email, required
    - `reason` string, nullable, required
    - `source` 'bounce' | 'complaint' | 'manual' | 'api' | 'unsubscribe' | 'import' | 'verification', required: How the address was suppressed: `bounce` and `complaint` from delivery feedback, `unsubscribe` when the recipient unsubscribed, `import` from an uploaded suppression list, `verification` when the address was checked before a campaign's first send to it and the mailbox does not exist or is a disposable inbox, and `api` or `manual` when you added it yourself (`POST /suppressions` records `api`).
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid cursor
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)