List suppression entries

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/suppression \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/suppression', 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://client-api.salesfinity.co/v2/sequencer/suppression",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://client-api.salesfinity.co/v2/sequencer/suppression"

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

	req.Header.Add("x-api-key", "<api-key>")

	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://client-api.salesfinity.co/v2/sequencer/suppression")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "data": [
    {
      "_id": "66fe11c2d3e4f5a6b7c8d9e0",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "type": "domain",
      "value": "globex.com",
      "reason": "manual",
      "source": "manual",
      "user": "64b7f0c2e4b0a1b2c3d4e5f1",
      "created_at": "2026-10-03T16:20:11.000Z",
      "updated_at": "2026-10-03T16:20:11.000Z"
    },
    {
      "_id": "66fa7d01b2c3d4e5f6a7b8e2",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "type": "email",
      "value": "[email protected]",
      "reason": "unsubscribed",
      "sequence": "66f0aa11b2c3d4e5f6a7b8c1",
      "contact": "66f9b1e0a2c3d4e5f6a7b8d3",
      "created_at": "2026-10-01T09:44:27.000Z",
      "updated_at": "2026-10-01T09:44:27.000Z"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "limit": 10,
    "pages": 1
  }
}

{
  "message": [
    "type must be one of the following values: email, domain, phone"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Suppression

List suppression entries

Returns a page of the team’s do-not-contact list, newest first.

Entries are added in three ways: automatically when a prospect unsubscribes, bounces or complains, when a call is dispositioned do-not-call in the dialer (the dialed number, reason dnc), and by hand in the dashboard or through this API. Values are stored normalized, so filter by type and reason and expect the stored form of what you added. Defaults to 10 entries per page. Counts against the Sequencer reads rate limit.

GET

sequencer

suppression

List suppression entries

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/suppression \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/suppression', 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://client-api.salesfinity.co/v2/sequencer/suppression",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://client-api.salesfinity.co/v2/sequencer/suppression"

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

	req.Header.Add("x-api-key", "<api-key>")

	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://client-api.salesfinity.co/v2/sequencer/suppression")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "data": [
    {
      "_id": "66fe11c2d3e4f5a6b7c8d9e0",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "type": "domain",
      "value": "globex.com",
      "reason": "manual",
      "source": "manual",
      "user": "64b7f0c2e4b0a1b2c3d4e5f1",
      "created_at": "2026-10-03T16:20:11.000Z",
      "updated_at": "2026-10-03T16:20:11.000Z"
    },
    {
      "_id": "66fa7d01b2c3d4e5f6a7b8e2",
      "team": "64b7f0c2e4b0a1b2c3d4e5f0",
      "type": "email",
      "value": "[email protected]",
      "reason": "unsubscribed",
      "sequence": "66f0aa11b2c3d4e5f6a7b8c1",
      "contact": "66f9b1e0a2c3d4e5f6a7b8d3",
      "created_at": "2026-10-01T09:44:27.000Z",
      "updated_at": "2026-10-01T09:44:27.000Z"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "limit": 10,
    "pages": 1
  }
}

{
  "message": [
    "type must be one of the following values: email, domain, phone"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

The team’s do-not-contact list, newest first. Most entries arrive on their own: unsubscribes, bounces and complaints are added automatically, and a do-not-call disposition in the dialer adds the dialed number.

Good to know

Values are stored normalized. An email or domain is lowercased; a phone number is stored as digits, without the leading 1 of a North American number.
Pages hold 10 entries unless you send limit (up to 100).
Filter with type and reason. There is no search by value in this API.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Query Parameters

limit

number

Results per page. Default 10. Above 100 is treated as 100.

Required range: 1 <= x <= 100

page

number

default:1

Page number, 1-based, up to 10,000.

Required range: 1 <= x <= 10000

type

enum<string>

Only entries of this kind.

Available options:

email,

domain,

phone

reason

enum<string>

Only entries with this reason. dnc is do-not-call.

Available options:

unsubscribed,

bounced,

complained,

manual,

dnc

Response

A page of entries.

A page of results.

data

object[]

required

Show child attributes

pagination

object

required

Pagination for the paged lists under /v2/sequencer. Every paged list uses this one shape; a few short lists (a sequence's steps, the team's policies, a task's events and enrollment runs) return a plain array instead.

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List suppression entries

Good to know

Authorizations

Query Parameters

Response

​Good to know

Authorizations

Query Parameters

Response

Good to know