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

# List suppression entries

`GET /suppressions`

## Request

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

Returns suppressed emails and domains (the blocklist) with cursor pagination.

Required scope: `suppressions:read`.

Returns a cursor-paginated list — pass `cursor` from the previous page to continue.

## Query parameters

- `limit` integer
- `cursor` string
- `type` 'email' | 'domain'

## Response `200`

Success

## Other responses

- `401`: `unauthorized` — Missing or invalid API key.
- `403`: `insufficient_scope` — The API key lacks the scope this endpoint requires.
- `429`: `rate_limited` — Too many requests — slow down and retry after the Retry-After delay.

---

[API](https://skmtc.dev/warmysender/apis/warmysender-public-api.md) · [All operations](https://skmtc.dev/warmysender/apis/warmysender-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/warmysender/apis/warmysender-public-api/revisions/289e9c167a1a?raw)