Skip to main content
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

​
cursor
string
Opaque pagination cursor from a previous response’s nextCursor.
​
limit
integer
Page size, 1–100 (default 25).

​
Request

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

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