List email suppressions — StatusDashboard Docs

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 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.
`email`	string	No	Filter to an exact email address (case-insensitive). Must be a valid email when provided.

Sample request

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

Sample response

Status: 200 OK

{
  "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.

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 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.

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.

On this page