API reference

List suppressions

Returns all suppressed addresses for the active tenant. Supports filtering by channel.

GET/v1/admin/suppressions

Authenticate with a session token and X-Tenant-Slug. Required role: any member.

Request

curl

curl "https://api-raven-cloud.autotribes.app/v1/admin/suppressions?channel=email&page=1&pageSize=50" \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "X-Tenant-Slug: acme-co"

Query parameters

Parameter	Type	Notes
`channel`	string · optional	`email` or `sms`. Omit to return all channels.
`page`	integer · optional	Page number, 1-indexed. Default: `1`
`pageSize`	integer · optional	Results per page. Default: `50`. Max: `200`.
`q`	string · optional	Search by address (partial match)

Response

200 OK

json

{
  "data": [
    {
      "id": "c1d2e3f4-a5b6-7c8d-9e0f-1a2b3c4d5e6f",
      "channel": "email",
      "address": "bad@bounced.example.com",
      "reason": "hard_bounce",
      "createdAt": "2026-04-28T14:22:00.000Z"
    },
    {
      "id": "d2e3f4a5-b6c7-8d9e-0f1a-2b3c4d5e6f7a",
      "channel": "email",
      "address": "complained@example.com",
      "reason": "spam_complaint",
      "createdAt": "2026-04-29T09:10:00.000Z"
    }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 50
}

Errors

Status	When
`400`	Invalid channel value or pageSize out of range
`401`	Invalid or expired session token
`403`	Caller is not a member of the tenant