Suppressions

List suppressed addresses

Retrieve a list of the email addresses your workspace has suppressed, newest-first and cursor-paginated. The list holds your workspace's own suppressions only. Unitpost-wide (platform) blocks are enforced at send time but never listed: they appear as email.suppressed on the send they stopped, and Retrieve a suppressed address with an email address still returns one, so you can see why that address is blocked. (Since 2026-10-13; before that the list also included platform rows.) Add an address with Suppress an address or lift a block with Un-suppress an address. Requires the suppressions:read capability.

get/suppressions

Request

  • Base URL: https://www.unitpost.com/api/v1
  • URL: https://www.unitpost.com/api/v1/suppressions
  • Auth: HTTP bearer

Query parameters

limitinteger

Max rows to return (default 20, max 100).

afterstring

Return rows after this id (forward paging).

beforestring

Return rows before this id (backward paging).

scope'workspace' | 'platform'

Deprecated and ignored (2026-10-13). The list always returns your workspace's own suppressions; platform rows are never listed. Still accepted so existing callers don't break.

Response

A page of suppressed addresses.

object'list' required
has_moreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.