List enrollment refusals

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

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

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts', 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/sequences/{id}/enrollment-attempts",
  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/sequences/{id}/enrollment-attempts"

	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/sequences/{id}/enrollment-attempts")

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": "6650f2a1b2c3d4e5f6a7c001",
      "team": "64f1a2b3c4d5e6f7a8b9c0d1",
      "sequence": "6650c1f2a9b8c7d6e5f40123",
      "user": "64f1a2b3c4d5e6f7a8b9c0d2",
      "contact": {
        "_id": "6650d0a1b2c3d4e5f6a7b8c9",
        "first_name": "Sam",
        "last_name": "Ortiz",
        "email": "[email protected]",
        "account": "Globex"
      },
      "prospect": "[email protected]",
      "subject": "6650d0a1b2c3d4e5f6a7b8c9",
      "reason": "suppressed",
      "detail": "Contact is suppressed (email: unsubscribed)",
      "rule": null,
      "attempted_at": "2026-10-03T09:45:12.000Z",
      "created_at": "2026-10-03T09:45:12.000Z",
      "updated_at": "2026-10-03T09:45:12.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 25,
    "pages": 1
  },
  "summary": {
    "suppressed": 1,
    "already_enrolled": 4,
    "policy": 2
  },
  "total_refused": 7
}

{
  "message": [
    "reason must be one of the following values: policy, suppressed, already_enrolled, throttle_capacity, throttle_daily, contact_not_found, other"
  ],
  "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": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "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"
}

Sequences

List enrollment refusals

Lists the people who were not added to this sequence and why, most recent attempt first, 25 per page unless you set limit. It is the counterpart to GET /v2/sequencer/enrollments: check it when a batch adds fewer people than you sent.

Each row is the latest refusal for one person. Trying the same person again replaces their row rather than adding one, and the row is removed once they are enrolled. Rows are kept for 90 days.

reason is a stable code and detail the full message. summary counts refusals by reason across the whole sequence, whatever reason filter you pass, and total_refused is their sum. Counts toward the Sequencer reads rate limit.

GET

sequencer

sequences

{id}

enrollment-attempts

List enrollment refusals

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

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

fetch('https://client-api.salesfinity.co/v2/sequencer/sequences/{id}/enrollment-attempts', 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/sequences/{id}/enrollment-attempts",
  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/sequences/{id}/enrollment-attempts"

	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/sequences/{id}/enrollment-attempts")

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": "6650f2a1b2c3d4e5f6a7c001",
      "team": "64f1a2b3c4d5e6f7a8b9c0d1",
      "sequence": "6650c1f2a9b8c7d6e5f40123",
      "user": "64f1a2b3c4d5e6f7a8b9c0d2",
      "contact": {
        "_id": "6650d0a1b2c3d4e5f6a7b8c9",
        "first_name": "Sam",
        "last_name": "Ortiz",
        "email": "[email protected]",
        "account": "Globex"
      },
      "prospect": "[email protected]",
      "subject": "6650d0a1b2c3d4e5f6a7b8c9",
      "reason": "suppressed",
      "detail": "Contact is suppressed (email: unsubscribed)",
      "rule": null,
      "attempted_at": "2026-10-03T09:45:12.000Z",
      "created_at": "2026-10-03T09:45:12.000Z",
      "updated_at": "2026-10-03T09:45:12.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 25,
    "pages": 1
  },
  "summary": {
    "suppressed": 1,
    "already_enrolled": 4,
    "policy": 2
  },
  "total_refused": 7
}

{
  "message": [
    "reason must be one of the following values: policy, suppressed, already_enrolled, throttle_capacity, throttle_daily, contact_not_found, other"
  ],
  "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": "Sequence not found",
  "error": "Not Found",
  "statusCode": 404,
  "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"
}

Lists the people who were not added to this sequence and why, most recent attempt first, 25 per page unless you set limit. It is the counterpart to List enrollments: check it when a batch adds fewer people than you sent.

Example

curl 'https://client-api.salesfinity.co/v2/sequencer/sequences/6650c1f2a9b8c7d6e5f40123/enrollment-attempts?reason=policy' \
  -H 'x-api-key: YOUR_API_KEY'

Reason codes

`reason`	Meaning
`policy`	A rules-of-engagement rule blocked them. `rule` names it.
`suppressed`	They are on the suppression list.
`already_enrolled`	They already have a live enrollment in this sequence.
`throttle_capacity`	The owner was at the sequence’s `throttle_capacity`.
`throttle_daily`	The owner had reached the sequence’s `throttle_max_adds_per_day`.
`contact_not_found`	A `contact` id that is not on your team.
`other`	Anything else; `detail` has the message.

policy and suppressed are decisions about the person and worth reading one by one. The others are facts about the batch or the sequence’s limits.

Things to know

One row per person. Trying the same person again replaces their row instead of adding one, and the row is removed once they are enrolled. Rows are kept for 90 days.
summary ignores the filter. It counts refusals by reason across the whole sequence, whatever reason you pass, and total_refused is its sum. Use it to show the full breakdown while listing one reason.
detail is the message that Add contacts to a sequence returned in skipped[].reason. contact is null when the identifier you sent matched no contact.

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.

Path Parameters

string

required

24-character sequence id.

Query Parameters

limit

number

Results per page. Default 25. 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

reason

enum<string>

Only refusals with this code. policy: a rules-of-engagement rule blocked them. suppressed: on the suppression list. already_enrolled: already live in this sequence. throttle_capacity / throttle_daily: over the sequence's capacity or daily-add cap for the owner. contact_not_found: a contact id not on the team. other: anything else.

Available options:

policy,

suppressed,

already_enrolled,

throttle_capacity,

throttle_daily,

contact_not_found,

other

Response

A page of refusals.

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

summary

object

Refusals by reason code across the whole sequence, ignoring the reason filter. Codes with no refusals are left out.

Show child attributes

total_refused

integer

Sum of summary.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List enrollment refusals

Example

Reason codes

Things to know

Authorizations

Path Parameters

Query Parameters

Response

​Example

​Reason codes

​Things to know

Authorizations

Path Parameters

Query Parameters

Response

Example

Reason codes

Things to know