# List email suppressions

Retrieve the organization's email suppression list (hard bounces and complaints).

Source: https://statusdashboard.com/docs/api/subscriptions/email/suppression/list

`GET /app/subscribers/email/suppression`

Returns a paginated list of suppressed email addresses for the organization. Entries are created when the StatusDashboard transactional email provider reports a **permanent** bounce or a spam complaint on a tracked notification send.

Requires the `admin` or `subscriber` role and the **Email notifications** feature entitlement.

***

## Request
See [API Basics](/docs/api) for required headers.

### Query parameters
| Parameter   | Type    | Required | Description                                                                                             |
| ----------- | ------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `limit`     | integer | No       | Max entries per page. Range: 1–100. Default: `10`.                                                      |
| `nextToken` | string  | No       | Next-page bookmark from the previous response — pass unchanged. See [Pagination](/docs/api#pagination). |
| `email`     | string  | No       | Filter to an exact email address (case-insensitive). Must be a valid email when provided.               |

***

## Sample request
```bash
curl "https://api.statusdashboard.com/app/subscribers/email/suppression?email=bounce%40example.com" \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "suppressions": [
    {
      "email": "bounce@example.com",
      "reason": "bounce",
      "bounceType": "Permanent",
      "bounceSubType": "General",
      "detail": "Permanent / General",
      "suppressedAt": "2026-06-26T14:30:00.000Z",
      "lastEventAt": "2026-06-26T14:30:00.000Z"
    }
  ],
  "nextToken": null
}
```

***

## Response fields
| Field          | Type           | Description                                                                         |
| -------------- | -------------- | ----------------------------------------------------------------------------------- |
| `suppressions` | array          | Suppression entries for this page.                                                  |
| `nextToken`    | string \| null | Next-page bookmark when more results exist. See [Pagination](/docs/api#pagination). |

### Entry fields
Each `suppressions[]` item:

| Field           | Type              | Description                                        |
| --------------- | ----------------- | -------------------------------------------------- |
| `email`         | string            | Normalized suppressed address.                     |
| `reason`        | string            | `bounce` or `complaint`.                           |
| `bounceType`    | string \| omitted | bounce type (e.g. `Permanent`) for bounce entries. |
| `bounceSubType` | string \| omitted | bounce subtype when available.                     |
| `detail`        | string \| omitted | Human-readable summary from the event.             |
| `suppressedAt`  | string            | ISO 8601 — first time this address was suppressed. |
| `lastEventAt`   | string            | ISO 8601 — most recent event for this entry.       |

***

## Pagination
See [Pagination](/docs/api#pagination) in API Basics. Re-send the same query parameters on every page request.

***

## Retention
Suppression entries **do not expire**. They remain until removed via [DELETE suppression](/docs/api/subscriptions/email/suppression/delete).

***

## Gmail feedback loop limitation
Gmail does not send spam complaint feedback to StatusDashboard. Spam reports made in the Gmail web client will **not** create suppression entries in this list or in the StatusDashboard tenant suppression list. Other mailbox providers that participate in the feedback loop will generate complaint entries as expected.

***

## Error responses
| Status | When                                                                          |
| ------ | ----------------------------------------------------------------------------- |
| `400`  | Invalid query parameters (e.g. malformed `nextToken`).                        |
| `403`  | Not an admin, or the Email notifications feature is not enabled on your plan. |