Retrieve a suppressed address

GET/api/v1/suppressions/{id}

GET /suppressions/{id}

curl -X GET 'https://www.unitpost.com/api/v1/suppressions/123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'

Response · 200

{
  "object": "suppression",
  "id": "id_123",
  "email": "customer@example.com",
  "scope": "workspace",
  "reason": "bounce",
  "detail": "string",
  "note": "string",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Retrieve one suppression by id (supp_…) or by the email address itself. Returns your own workspace row, or a read-only platform row when the address is blocked Unitpost-wide. Lift a workspace block with Un-suppress an address. Requires the suppressions:read capability.

Parameters1 field

Field	Type	Description
`id`required	string · path	A suppression id (`supp_…`) or the email address.

Response · 200 fields9 fields

Field	Type	Description
`object`required	string	—
`id`required	string	—
`email`required	string	—
`scope`required	enumworkspace \| platform	—
`reason`required	enumbounce \| complaint \| unsubscribe \| manual \| import \| api	—
`detail`required	object	—
`note`required	object	—
`created_at`required	string	—
`updated_at`required	string	—

200401403404

Retrieve a suppressed address

Retrieve a suppressed address

Search docs and guides