HostingDelivery

List suppression list entries

GET/api/delivery/suppression_lists

Returns suppression list entries for the current customer context.

X-Api-Token<token>

API token used to authenticate requests.

In: header

Query Parameters

page?integer

Page number

Format int32Default 1
per?integer

Results per page

Format int32Default 25
query?string

Search query

account_id?string
account_code?string
status?string

Suppression entry status filter.

  • all = include enabled and disabled resources.
  • enabled = active and usable.
  • disabled = disabled.
Values all | enabled | disabled
reason?string

Suppression reason filter.

  • complaint = recipient complaint.
  • bounce = delivery bounce.
Values complaint | bounce
category?string
added_on?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/delivery/suppression_lists" \  -H "X-Api-Token: YOUR_API_TOKEN" \  -H "Accept: application/json"
{
  "resources": [
    {
      "active": "string",
      "id": "string",
      "email": "string",
      "customer_id": "string",
      "reason": "complaint",
      "category": "string",
      "message": "string",
      "message_translated": "string",
      "accounts": "string",
      "created_at": "string"
    }
  ],
  "pagination": {}
}
{
  "message": "Unauthorized",
  "errors": []
}
{
  "message": "Forbidden",
  "errors": []
}
{
  "message": "Not found",
  "errors": []
}
{
  "message": "Validation failed",
  "errors": [
    {
      "field": "name",
      "description": "is not valid"
    }
  ]
}