GET

api

suppressions

{email}

Get Recipient Suppression

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

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

fetch('https://api.sequenzy.com/api/v1/suppressions/{email}', 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/{email}",
  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/{email}"

	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/{email}")

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,
  "suppression": {
    "email": "user@example.com",
    "knownRecipient": true,
    "suppressed": true,
    "local": {
      "suppressed": false,
      "suppressionType": null,
      "reason": null,
      "source": null,
      "suppressionId": null,
      "scope": null,
      "delistable": false
    },
    "ses": {
      "regionsChecked": ["us-east-1"],
      "entries": [
        {
          "email": "user@example.com",
          "region": "us-east-1",
          "reason": "BOUNCE",
          "lastUpdateTime": "2026-07-15T09:00:00.000Z",
          "messageId": "ses-message-id",
          "feedbackId": "feedback-id"
        }
      ]
    }
  }
}

Get Recipient Suppression

Checks one exact recipient against Sequenzy’s local bounce and complaint safeguards and the Amazon SES account-level suppression list. This endpoint does not list unrelated recipients from the shared SES account. By default, Sequenzy checks the default SES region and every region currently used by the company’s sending domains.

Request

string

required

Exact recipient email address. URL-encode the value when constructing the request URL.

string

Optional AWS SES region such as us-east-1. Use this to limit the lookup to one known region.

curl "https://api.sequenzy.com/api/v1/suppressions/user%40example.com" \
  -H "Authorization: Bearer API_KEY"

Response

{
  "success": true,
  "suppression": {
    "email": "user@example.com",
    "knownRecipient": true,
    "suppressed": true,
    "local": {
      "suppressed": false,
      "suppressionType": null,
      "reason": null,
      "source": null,
      "suppressionId": null,
      "scope": null,
      "delistable": false
    },
    "ses": {
      "regionsChecked": ["us-east-1"],
      "entries": [
        {
          "email": "user@example.com",
          "region": "us-east-1",
          "reason": "BOUNCE",
          "lastUpdateTime": "2026-07-15T09:00:00.000Z",
          "messageId": "ses-message-id",
          "feedbackId": "feedback-id"
        }
      ]
    }
  }
}

local.scope describes how far a local suppression reaches: global when the SMTP evidence conclusively identified an invalid destination and every workspace is blocked, company when the block is contained to your workspace (an ambiguous hard bounce, repeated delivery failures of your own sends, or a spam complaint against your email). Global invalid-recipient suppressions and SES account-level suppressions are protected; only company-scoped soft-bounce escalations can be removed. It is null when the address is not locally suppressed. Use List Suppressed Recipients to see every suppressed address at once. local.suppressionType uses the same stable values as the list: invalid_recipient, unknown_hard_bounce, soft_bounce_escalation, or complaint. local.delistable is true only for soft_bounce_escalation. knownRecipient indicates whether the address appears in this company’s subscriber or email-send history. Unknown addresses return empty local and SES results so the endpoint cannot be used to probe suppressions belonging only to another company on the shared SES account.

Get Recipient Suppression

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

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

fetch('https://api.sequenzy.com/api/v1/suppressions/{email}', 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/{email}",
  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/{email}"

	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/{email}")

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,
  "suppression": {
    "email": "user@example.com",
    "knownRecipient": true,
    "suppressed": true,
    "local": {
      "suppressed": false,
      "suppressionType": null,
      "reason": null,
      "source": null,
      "suppressionId": null,
      "scope": null,
      "delistable": false
    },
    "ses": {
      "regionsChecked": ["us-east-1"],
      "entries": [
        {
          "email": "user@example.com",
          "region": "us-east-1",
          "reason": "BOUNCE",
          "lastUpdateTime": "2026-07-15T09:00:00.000Z",
          "messageId": "ses-message-id",
          "feedbackId": "feedback-id"
        }
      ]
    }
  }
}

​Get Recipient Suppression

​Request

​Response

Get Recipient Suppression

Request

Response