API Reference · Suppressions

List suppressions

List suppressed addresses. Most land here automatically on hard bounce or complaint.

GET/v1/suppressions

Headers

Authorizationstringrequired

Your API key as a bearer token: Bearer rk_your_api_key. You can also use the X-Api-Key header.

Request

curl -X GET https://api.raanse.com/v1/suppressions \
  -H "Authorization: Bearer rk_your_api_key"

Response

200

{
  "success": true,
  "message": "OK",
  "statusCode": 200,
  "data": [{ "id": "01JABCDXYZ0000000000000000", "email": "bounced@example.com", "reason": "HardBounce", "source": "acs-event-grid", "createdAt": "2026-07-02T12:00:00Z" }]
}