---
title: "List suppressions or category opt-outs"
method: GET
path: "/suppressions"
tags: ["Suppressions"]
---

# List suppressions or category opt-outs

`GET /suppressions`

## Request

- Base URL: `https://api.groundmail.dev`
- URL: `https://api.groundmail.dev/suppressions`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `email` string, email
- `tenant` string
- `type` 'suppression' | 'category_opt_out'
- `category` 'product' | 'newsletter'
- `include_tenants` boolean

## Response `200`

Suppression list, or category opt-outs with `type=category_opt_out` (`ListCategoryOptOutsResponse`).

- union
  - ListSuppressionsResponse
    - `data` Suppression[], required
      - `id` string, required
      - `email` string, email, required
      - `reason` string, nullable, required
      - `source` 'bounce' | 'complaint' | 'manual' | 'api' | 'unsubscribe', required
      - `tenant` string: The tenant's `external_id`. Present only on entries of a tenant's list.
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
  - ListCategoryOptOutsResponse
    - `data` CategoryOptOut[], required
      - `id` string, uuid, required
      - `type` 'category_opt_out', required
      - `email` string, email, required
      - `category` 'product' | 'newsletter', required
      - `tenant` string, nullable, required: External id of the tenant whose email the reader left; `null` when account-wide.
      - `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 `type`, `category` or cursor
- `401`: Missing or invalid API key

## Changes

- **2026-10-19** `479821c9fecf`: 5 breaking, 4 info
  - added `#/components/schemas/ListSuppressionsResponse, #/components/schemas/ListCategoryOptOutsResponse` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `data` from the response with the `200` status
  - removed the required property `has_more` from the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/groundmail/apis/groundmail-api/changes/suppressions/get.md)

---

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