---
title: "List the suppressed addresses"
method: GET
path: "/v1/suppressions"
tags: ["Suppressions"]
---

# List the suppressed addresses

`GET /v1/suppressions`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/suppressions`
- Auth: HTTP bearer

Addresses a stream of the server will not send to: hard bounces, spam complaints and entries added by hand, newest first, one page at a time. The default stream unless streamId names another; every stream has a list of its own. A send to any of them is refused with recipient_suppressed.

## Query parameters

- `streamId` string, uuid
- `limit` integer
- `after` string, uuid

## Response `200`

A page of the stream's suppression list, newest first.

- object: A page of the stream's suppression list, newest first.
  - `suppressions` object[], required
    - `streamId` string, uuid, required: The stream whose list the address is on.
    - `address` string, required: The recipient, lower-cased.
    - `reason` 'hard_bounce' | 'spam_complaint' | 'manual' | 'unsubscribe', required: A hard bounce or a manual entry may be lifted here; a spam complaint or the recipient’s own unsubscribe only by Sendora support. manual is an address added by hand in the dashboard.
    - `messageId` string, uuid, nullable, required: The message whose bounce or complaint put it here.
    - `createdAt` string, date-time, required
  - `next` string, uuid, nullable, required: Pass as `after` for the next page; null on the last.

## Other responses

- `400`: The body, the query or a header does not match what the route takes.
- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.
- `422`: The streamId names no stream of this server, or an inbound stream.

---

[API](https://skmtc.dev/sendora/apis/sendora-api.md) · [All operations](https://skmtc.dev/sendora/apis/sendora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendora/apis/sendora-api/revisions/72efbbb34b64?raw)