GET

api

suppressions

{email}

Get Recipient Suppression

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.sequenzy.com/api/v1/suppressions/{email}")
  .header("Authorization", "Bearer <token>")
  .asString();

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,
      "reason": null,
      "source": null,
      "suppressionId": null
    },
    "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.

region

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,
      "reason": null,
      "source": null,
      "suppressionId": null
    },
    "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"
        }
      ]
    }
  }
}

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.

Remove Recipient SuppressionRemove stale bounce suppression for one company-associated recipient.

Get Recipient Suppression

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.sequenzy.com/api/v1/suppressions/{email}")
  .header("Authorization", "Bearer <token>")
  .asString();

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,
      "reason": null,
      "source": null,
      "suppressionId": null
    },
    "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