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

# List suppressed recipients

`GET /suppressions`

Lists the recipients this company cannot reach, newest suppression first by default.

Four product-level suppression types appear:

- `suppressionType: invalid_recipient` - SMTP evidence conclusively identifies an invalid destination. It is global, visible to companies associated with the address, and protected.
- `suppressionType: unknown_hard_bounce` - a permanent/undetermined failure without enough evidence to declare the inbox invalid. It is company-scoped and protected.
- `suppressionType: soft_bounce_escalation` - repeated delivery failures from this company. It is company-scoped and removable.
- `suppressionType: complaint` - the recipient reported this company's email as spam. It is company-scoped and protected.

The platform-wide list is never exposed: a global row is returned only when the address is already associated with the authenticated company.

## Query parameters

- `search` string
- `page` integer
- `limit` integer
- `sort` 'suppressedAt' | 'email' | 'status'
- `order` 'asc' | 'desc'

## Response `200`

Suppressed recipients

- object
  - `success` boolean
  - `suppressions` object[]
    - `email` string, email
    - `suppressionType` 'invalid_recipient' | 'unknown_hard_bounce' | 'soft_bounce_escalation' | 'complaint' — Stable product-level classification independent of provider bounce sub-types.
    - `reason` 'bounced' | 'complaint'
    - `scope` 'global' | 'company' — global blocks every workspace; company blocks only this one.
    - `source` 'bounced_email' | 'email_send_complaint'
    - `bounceType` string, nullable
    - `bounceSubType` string, nullable
    - `bounceCount` integer, nullable
    - `suppressedAt` string, date-time
    - `delistable` boolean — True only for company-scoped soft-bounce escalations.
  - `total` integer
  - `page` integer
  - `limit` integer
  - `hasMore` boolean
  - `sortBy` 'suppressedAt' | 'email' | 'status' — The sort field actually applied.
  - `sortOrder` 'asc' | 'desc' — The sort direction actually applied.

## Other responses

- `401` — Unauthorized
- `403` — No company selected
- `500` — Internal server error
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/73f826277d9a/schema)