List suppressions

GET/v1/admin/suppressionsAdmin key

The suppression list is shared by every project on the mailer. A live send to any address on it fails with 422 recipient_suppressed. Hard bounces and spam complaints are added automatically when Cloudflare reports them; you can also add and remove addresses by hand. See Suppressions.

This is Flaresend's local list. Cloudflare keeps its own suppression list, which you edit in the Cloudflare dashboard; every response carries a note saying so.

Query parameters

qstringquery

Only addresses that contain this text, for example example.com.

limitintegerquerydefault: 50

Page size, 1 to 200.

cursorstringquery

The nextCursor from the previous page.

Response

dataSuppression[]

The suppressed addresses, sorted by address.

Show suppression properties

addressstring

The lowercased address.

reason'hard_bounce' | 'complaint' | 'manual'

Why it was suppressed.

sourceEmailIdstring | null

The email whose bounce or complaint added it, or null when added by hand.

createdAtstring

When it was added.

nextCursorstring | null

Pass it as cursor for the next page. null on the last page.

notestring

A reminder that Cloudflare keeps a separate suppression list.

Request

const res = await fetch(
  'https://mailer.example.com/v1/admin/suppressions?q=example.com',
  { headers: { Authorization: `Bearer ${process.env.FLARESEND_ADMIN_KEY}` } },
);
const { data, nextCursor } = await res.json();

Response

{
  "data": [
    {
      "address": "ada@example.com",
      "reason": "hard_bounce",
      "sourceEmailId": "email_01K6B2Y4ZP9R3M7T8V5N2QXW4C",
      "createdAt": "2026-09-26T10:20:04.000Z"
    },
    {
      "address": "grace@example.com",
      "reason": "manual",
      "sourceEmailId": null,
      "createdAt": "2026-09-26T11:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "note": "This is Flaresend's local mirror. Cloudflare keeps its own suppression list; edit that one in the Cloudflare dashboard (Email Service)."
}

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

Query parameters

Response