List the suppressed addresses

GET/v1/suppressions

TypeScript sendora.suppressions.list(query)

Python sendora.suppressions.list(stream_id=..., limit=..., after=...)

Key sk_… a server key

Addresses a stream of the server will not send to: hard bounces, spam complaints and entries added by hand, newest first, one page at a time. The default stream unless streamId names another; every stream has a list of its own. A send to any of them is refused with recipient_suppressed.

Parameters

• streamIdin querystring (uuid)

  The stream whose list is meant; the default transactional stream when absent.

• limitin queryinteger (1 to 1000)

  Page size, 1 to 1000.

• afterin querystring (uuid)

  The next value of the previous page.

Responses

{
  "suppressions": [
    {
      "streamId": "3d1a2b4c-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "address": "anna@example.com",
      "reason": "hard_bounce",
      "messageId": "5f432ffd-c005-499b-aa3a-5b8a088ea20e",
      "createdAt": "2026-09-15T12:00:00.000Z"
    }
  ],
  "next": null
}

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

{
  "error": "invalid_request",
  "message": "The request is invalid: to.0: Invalid email address",
  "issues": [
    {
      "path": "to.0",
      "message": "Invalid email address"
    }
  ]
}