GET

api

suppressions

List Suppressed Recipients

curl --request GET \
  --url https://api.sequenzy.com/api/v1/suppressions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/suppressions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/suppressions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/suppressions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/suppressions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "suppressions": [
    {
      "email": "user@example.com",
      "suppressionType": "invalid_recipient",
      "reason": "bounced",
      "scope": "global",
      "source": "bounced_email",
      "bounceType": "Permanent",
      "bounceSubType": "General",
      "bounceCount": 1,
      "suppressedAt": "2026-07-15T09:00:00.000Z",
      "delistable": false
    },
    {
      "email": "reporter@example.com",
      "suppressionType": "complaint",
      "reason": "complaint",
      "scope": "company",
      "source": "bounced_email",
      "bounceType": null,
      "bounceSubType": null,
      "bounceCount": null,
      "suppressedAt": "2026-06-02T11:30:00.000Z",
      "delistable": false
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 25,
  "hasMore": false,
  "sortBy": "suppressedAt",
  "sortOrder": "desc"
}

{ "success": false, "error": "Invalid API key" }

{ "success": false, "error": "No company selected" }

List Suppressed Recipients

Lists every recipient your workspace is currently blocked from mailing, newest suppression first. Suppressed recipients are silently skipped by campaigns, sequences, and transactional sends, so this is the first place to look when someone reports missing email. Global rows are returned only when the address is already associated with your workspace through recipient history; the shared platform list is never exposed. Use Get Recipient Suppression for a full check of one address that also queries Amazon SES, and Remove Recipient Suppression to clear a workspace soft-bounce escalation.

Entry types

New suppressions persist their stable type in bounced_email.suppression_type. Historical complaint sends are still included as a compatibility fallback, so older complaint entries can report source: "email_send_complaint" while new ones report source: "bounced_email".

suppressionType: "invalid_recipient" - the mail provider reported a destination-address failure that conclusively identifies an invalid address. Its scope is global, it is shown as protected to every workspace associated with the address, and it cannot be removed by a workspace.
suppressionType: "unknown_hard_bounce" - the provider reported a permanent or undetermined failure, but its SMTP evidence did not prove the inbox was invalid. Its scope is company and it is protected.
suppressionType: "soft_bounce_escalation" - repeated delivery failures of your own sends escalated the address. Its scope is company, and it can be removed by an administrator for that workspace.
reason: "complaint" - the recipient reported one of your emails as spam. Its suppressionType is complaint, its scope is company, and it is protected: delistable is false and removal is refused.

Only addresses that are actually blocked appear. An address partway through the repeated-failure count is still deliverable and is not listed until it escalates.

Request

string

Case-insensitive substring filter on the recipient email address.

number

1-based page number. Defaults to 1.

number

Entries per page. Defaults to 25, maximum 100.

string

Field to order by: suppressedAt (default), email, or status. Use status to list the removable workspace escalations before the protected suppressions. An unrecognized value falls back to suppressedAt instead of failing the request - read sortBy in the response to confirm what was applied.

string

Sort direction, asc or desc. Defaults to desc for suppressedAt and status, asc for email.

curl "https://api.sequenzy.com/api/v1/suppressions?limit=25&sort=status&order=desc" \
  -H "Authorization: Bearer API_KEY"

Responses

{
  "success": true,
  "suppressions": [
    {
      "email": "user@example.com",
      "suppressionType": "invalid_recipient",
      "reason": "bounced",
      "scope": "global",
      "source": "bounced_email",
      "bounceType": "Permanent",
      "bounceSubType": "General",
      "bounceCount": 1,
      "suppressedAt": "2026-07-15T09:00:00.000Z",
      "delistable": false
    },
    {
      "email": "reporter@example.com",
      "suppressionType": "complaint",
      "reason": "complaint",
      "scope": "company",
      "source": "bounced_email",
      "bounceType": null,
      "bounceSubType": null,
      "bounceCount": null,
      "suppressedAt": "2026-06-02T11:30:00.000Z",
      "delistable": false
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 25,
  "hasMore": false,
  "sortBy": "suppressedAt",
  "sortOrder": "desc"
}

{ "success": false, "error": "Invalid API key" }

{ "success": false, "error": "No company selected" }

List Suppressed Recipients

curl --request GET \
  --url https://api.sequenzy.com/api/v1/suppressions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/suppressions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/suppressions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/suppressions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/suppressions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "suppressions": [
    {
      "email": "user@example.com",
      "suppressionType": "invalid_recipient",
      "reason": "bounced",
      "scope": "global",
      "source": "bounced_email",
      "bounceType": "Permanent",
      "bounceSubType": "General",
      "bounceCount": 1,
      "suppressedAt": "2026-07-15T09:00:00.000Z",
      "delistable": false
    },
    {
      "email": "reporter@example.com",
      "suppressionType": "complaint",
      "reason": "complaint",
      "scope": "company",
      "source": "bounced_email",
      "bounceType": null,
      "bounceSubType": null,
      "bounceCount": null,
      "suppressedAt": "2026-06-02T11:30:00.000Z",
      "delistable": false
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 25,
  "hasMore": false,
  "sortBy": "suppressedAt",
  "sortOrder": "desc"
}

{ "success": false, "error": "Invalid API key" }

{ "success": false, "error": "No company selected" }

​List Suppressed Recipients

​Entry types

​Request

​Responses

List Suppressed Recipients

Entry types

Request

Responses