Dashboard

Suppressions

List suppressions

List every suppressed address on the connected account, newest first. Not paginated. reason is bounce, unsubscribe, manual, or the value set when it was added.

GEThttps://api.sndr.sh/api/cranl/v1/suppressions
List suppressions
curl 'https://api.sndr.sh/api/cranl/v1/suppressions' \
  -H 'Authorization: Bearer sndr_your_access_token'
200OK
{
  "data": [
    {
      "organization_id": "org_8d41c7a2-3f6",
      "address":         "hard-bounce@example.com",
      "reason":          "bounce",
      "detail":          "550 5.1.1 user unknown",
      "created_at":      "2026-05-15T10:30:00Z"
    },
    {
      "organization_id": "org_8d41c7a2-3f6",
      "address":         "optout@example.com",
      "reason":          "manual",
      "created_at":      "2026-05-10T08:00:00Z"
    }
  ]
}

Authorization

Authorizationstringheaderrequired

Bearer followed by an access token. Needs the read scope.

Errors

401unauthenticatedMissing or invalid Bearer token.
401token_expiredAccess token expired — exchange the refresh token for a new pair.
401token_revokedToken was explicitly revoked.
403insufficient_scopeToken is missing the read scope.