List suppressions

The suppression list is the project’s send-time block list. Any address on it is dropped before send — even if you ask to mail it. List the current entries here. GET /v1/suppressions

Query parameters

string

Opaque pagination cursor from a previous response’s nextCursor.

integer

Page size, 1–100 (default 25).

Request

curl https://api.drin.run/v1/suppressions \
  -H "Authorization: Bearer $DRIN_API_KEY"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const page = await drin.suppressions.list();
for (const s of page.data) {
  console.log(s.email, s.reason, s.createdAt);
}

Response

Returns 200 OK with a page of suppressed addresses. Each entry carries a reason — one of hard_bounce, complaint, unsubscribe, or manual — and the time it was added.

200 OK

{
  "data": [
    {
      "email": "bounced@example.com",
      "reason": "hard_bounce",
      "createdAt": "2026-06-01T12:04:55.000Z"
    },
    {
      "email": "spam-report@example.com",
      "reason": "complaint",
      "createdAt": "2026-05-29T08:11:02.000Z"
    }
  ],
  "nextCursor": null
}

Suppression vs. unsubscribe. Suppressions block delivery. They are separate from a contact’s subscribed flag, which is an app-level marketing signal. See Suppressions.

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

List suppressions

Query parameters

Request

Response

​Query parameters

​Request

​Response

Query parameters

Request

Response