List suppressed addresses

GET/api/v1/suppressions

The workspace's suppression list, one page at a time. Useful for keeping a web shop in sync with unsubscriptions.

Scope

contacts:read Read contacts – the person behind the key must be all members.

Query parameters

limitinteger: The maximum number of items in the response (1–500, default 100).at least 1 · at most 500 · default 100
cursorstring: next_cursor from the previous response, for the next page. Omit for the first page.
reasonstring: Only suppressions of that type.unsubscribedbouncedcomplainedmanualimported

Response

200 A page of suppressed addresses.

dataarray<object>required
data[].emailstringrequired
data[].reasonstringrequired: unsubscribed, bounced, complained, manual or imported.
data[].detailstring | nullrequired
data[].created_atstring (time, ISO 8601)required: When the address was suppressed.
data[].contact_idstring | nullrequired: The contact with the address, if there is one that the key may see.
has_morebooleanrequired: There are more: fetch the next page with cursor=next_cursor.
next_cursorstring | nullrequired: Send as cursor for the next page. null on the last page.

Errors

401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
422: validation_failed
429: rate_limited
500: internal_error

Request

curl 'https://newsletter.qrona.se/api/v1/suppressions' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY"

Response 200

{
  "data": [
    {
      "email": "nej-tack@example.se",
      "reason": "unsubscribed",
      "detail": "Avregistrerad via länk",
      "created_at": "2026-10-01T07:00:00.000Z",
      "contact_id": "877"
    }
  ],
  "has_more": false,
  "next_cursor": null
}