---
title: "Get email suppressions"
method: GET
path: "/email-suppressions"
tags: ["email-suppressions"]
---

# Get email suppressions

`GET /email-suppressions`

## Request

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

Returns the email addresses Pylon will not send to, most recently suppressed first. Pass `email` to check a single address; an empty `data` array means it is not suppressed.

**Rate limit:** 300 requests per minute

## Query parameters

- `email` string
- `cursor` string
- `limit` integer

## Response `200`

- GetEmailSuppressionsResponseBody
  - `data` EmailSuppression[], required: The data payload of the response.
    - `bounce_details` string: The SMTP diagnostic from the receiving server, when Pylon observed the bounce.
    - `created_at` string, date-time, required: When the address was suppressed, in RFC3339 format.
    - `email` string, required: The suppressed email address.
    - `id` string, required: The ID of the email suppression.
    - `reason` string, required: Why the address is suppressed. Known values: `hard_bounce`, `manual`. This list is not exhaustive.
  - `pagination` Pagination: Pagination information for list responses. Absent when there are no more results.
    - `cursor` string, required: The cursor for the next page of results.
    - `has_next_page` boolean, required: Indicates if there is a next page of results.
  - `request_id` string, required: The request ID for tracking.

## Other responses

- `400`: The request was invalid or could not be completed.
- `401`: The request could not be authenticated for this API.
- `403`: The authenticated caller or organization is not allowed to access this endpoint or operation.
- `429`: The request exceeded the applicable rate limit.
- `500`: An unexpected internal error occurred.

## Changes

- **2026-10-11** `dfb481067e5a`: 73 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - the response property `data` became required for the status `200`
  - the response property `data/items/created_at` became required for the status `200`
  - …69 more
- **2026-09-12** `e85c0a2a3253`: 3 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `500` status
- **2026-09-10** `8a1a71062385`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/usepylon/apis/pylon-api.md) - [All operations](https://skmtc.dev/usepylon/apis/pylon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usepylon/apis/pylon-api/revisions/7d018a2a6265?raw)