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/suppressions01 Query parameters
cursorstringOptional
Opaque pagination cursor from a previous response's
nextCursor.limitintegerOptional
Page size,
1–100 (default 25).02 Request
curl https://api.drin.run/v1/suppressions \
-H "Authorization: Bearer $DRIN_API_KEY"03 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.
{
"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. unsubscribeSuppressions block delivery. They are separate from a contact's
subscribed flag, which is an app-level marketing signal. See Suppressions.