Skip to main content
GET
Get Suppressions

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

The ID of the org

Query Parameters

Search suppressions by identifier

Maximum string length: 256
channel
enum<string>

The channel an identifier is suppressed on

Available options:
EMAIL,
PHONE
reason
enum<string>

Why the identifier is suppressed

Available options:
BOUNCE,
COMPLAINT,
UNSUBSCRIBE,
MANUAL,
LEGAL
source
enum<string>

What put the identifier on the list

Available options:
WEBHOOK,
UNSUBSCRIBE_LINK,
ADMIN,
IMPORT,
API
page
number

Page number

take
number

Number of items to take

next
string

Next page token (Only used on special endpoints)

Response

200 - application/json
id
string
required
channel
enum<string>
required

The channel an identifier is suppressed on

Available options:
EMAIL,
PHONE
identifier
string
required
reason
enum<string>
required

Why the identifier is suppressed

Available options:
BOUNCE,
COMPLAINT,
UNSUBSCRIBE,
MANUAL,
LEGAL
source
enum<string>
required

What put the identifier on the list

Available options:
WEBHOOK,
UNSUBSCRIBE_LINK,
ADMIN,
IMPORT,
API
note
string | null
required
metadata
object | null
required

Diagnostic context kept alongside a suppression

created_by
object
required

Who added the entry. Null when it landed automatically (bounce, complaint, unsubscribe link).

created_at
string<date-time>
required
updated_at
string<date-time>
required