GET

api

sequences

{sequenceId}

enrollments

List Sequence Enrollments

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

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments"

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/sequences/{sequenceId}/enrollments', 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/sequences/{sequenceId}/enrollments",
  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/sequences/{sequenceId}/enrollments"

	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/sequences/{sequenceId}/enrollments")

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,
  "sequenceId": "seq_abc123",
  "sequenceName": "Onboarding",
  "statuses": ["waiting"],
  "enrollments": [
    {
      "enrollmentId": "tok_abc123",
      "sequenceId": "seq_abc123",
      "subscriberId": "sub_abc123",
      "email": "customer@example.com",
      "firstName": "Wanda",
      "lastName": "Waiter",
      "subscriberStatus": "active",
      "status": "waiting",
      "currentNodeId": "node_wave_1",
      "currentNodeType": "logic_delay",
      "currentNodeLabel": "Start at Wave 1",
      "currentNodeMissing": false,
      "enrollmentKey": "__default__",
      "enrollmentStartedAt": "2026-01-01T00:00:00.000Z",
      "waitUntil": "2026-01-04T00:00:00.000Z",
      "lastUpdatedAt": "2026-01-01T00:00:00.000Z",
      "failedReason": null,
      "movedFromNodeId": null,
      "movedAt": null,
      "moveReason": null
    }
  ],
  "pagination": {
    "limit": 500,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false
  }
}

{
  "error": "Invalid status filter `paused`. Valid values: active, waiting, completed, failed, cancelled"
}

{
  "error": "Invalid API key"
}

{
  "error": "No companies found. Create a company first using the create_company tool."
}

{
  "error": "Sequence not found"
}

List Sequence Enrollments

List the contacts enrolled in one sequence, with the node each one is currently sitting on. Use this when sequence stats gives you enrollmentCounts and you need the actual subscribers behind a number - for example, everyone waiting at one step. By default the response includes only active and waiting enrollments, which is every contact still moving through the sequence.

Request

string

required

Sequence ID.

string

Comma-separated enrollment statuses to include: active, waiting, completed, failed, or cancelled. Defaults to active,waiting.

string

Comma-separated sequence node IDs. Only enrollments currently sitting on one of these nodes are returned. Node IDs come from Get Sequence or from enrollmentCounts.byCurrentNode in sequence stats.

string

Comma-separated subscriber IDs. Use this to check where specific contacts stand.

string

Exact email address to match, case-insensitive.

string

Result order: enrolled_at_desc (default), enrolled_at_asc, wait_until_asc, or wait_until_desc. Use wait_until_asc to see which contacts resume next; enrollments with no scheduled resume sort last.

number

Enrollments per page, 1-500. Defaults to 50. Values above 500 are capped.

number

Number of enrollments to skip. Page until pagination.hasMore is false.

curl "https://api.sequenzy.com/api/v1/sequences/seq_abc123/enrollments?currentNodeId=node_wave_1&status=waiting&sort=wait_until_asc&limit=500" \
  -H "Authorization: Bearer seq_live_xxx"

Exporting the full list

Page with limit and offset until pagination.hasMore is false. The CLI does this loop for you and writes a CSV:

sequenzy sequences enrollments seq_abc123 --node-id node_wave_1 --all --csv enrollments.csv

Response fields

Each enrollment is one run through the sequence, identified by enrollmentId.

waitUntil is when a waiting enrollment is scheduled to resume, or null when nothing is scheduled.
lastUpdatedAt is the last change to the enrollment. For a waiting enrollment this is when it arrived at its current node; the platform does not separately track node entry time.
currentNodeMissing is true when the node an enrollment sits on has been deleted from the sequence graph. currentNodeType and currentNodeLabel are omitted in that case.
email falls back to the address captured at enrollment when the subscriber record no longer exists.
failedReason explains why a failed enrollment stopped, and is null for every other status. Failures are terminal - the enrollment is not retried - so this is the only record of what went wrong.
movedFromNodeId, movedAt, and moveReason record a release performed by move enrollments. They are null for an enrollment that reached its current step on its own, so they are how you tell a released wave apart from organic arrivals.

Diagnosing a failing step

Filter to failures and group them by currentNodeId:

curl "https://api.sequenzy.com/api/v1/sequences/seq_abc123/enrollments?status=failed" \
  -H "Authorization: Bearer API_KEY"

The same failedReason on the same currentNodeId across several enrollments points at that step’s configuration or content, not at the contacts. GET /v1/sequences/{sequenceId}/stats reports the same reasons per step as steps[].failedCount and steps[].failedSubscribers[].

Responses

{
  "success": true,
  "sequenceId": "seq_abc123",
  "sequenceName": "Onboarding",
  "statuses": ["waiting"],
  "enrollments": [
    {
      "enrollmentId": "tok_abc123",
      "sequenceId": "seq_abc123",
      "subscriberId": "sub_abc123",
      "email": "customer@example.com",
      "firstName": "Wanda",
      "lastName": "Waiter",
      "subscriberStatus": "active",
      "status": "waiting",
      "currentNodeId": "node_wave_1",
      "currentNodeType": "logic_delay",
      "currentNodeLabel": "Start at Wave 1",
      "currentNodeMissing": false,
      "enrollmentKey": "__default__",
      "enrollmentStartedAt": "2026-01-01T00:00:00.000Z",
      "waitUntil": "2026-01-04T00:00:00.000Z",
      "lastUpdatedAt": "2026-01-01T00:00:00.000Z",
      "failedReason": null,
      "movedFromNodeId": null,
      "movedAt": null,
      "moveReason": null
    }
  ],
  "pagination": {
    "limit": 500,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false
  }
}

{
  "error": "Invalid status filter `paused`. Valid values: active, waiting, completed, failed, cancelled"
}

{
  "error": "Invalid API key"
}

{
  "error": "No companies found. Create a company first using the create_company tool."
}

{
  "error": "Sequence not found"
}

List Sequence Enrollments

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

import requests

url = "https://api.sequenzy.com/api/v1/sequences/{sequenceId}/enrollments"

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/sequences/{sequenceId}/enrollments', 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/sequences/{sequenceId}/enrollments",
  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/sequences/{sequenceId}/enrollments"

	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/sequences/{sequenceId}/enrollments")

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,
  "sequenceId": "seq_abc123",
  "sequenceName": "Onboarding",
  "statuses": ["waiting"],
  "enrollments": [
    {
      "enrollmentId": "tok_abc123",
      "sequenceId": "seq_abc123",
      "subscriberId": "sub_abc123",
      "email": "customer@example.com",
      "firstName": "Wanda",
      "lastName": "Waiter",
      "subscriberStatus": "active",
      "status": "waiting",
      "currentNodeId": "node_wave_1",
      "currentNodeType": "logic_delay",
      "currentNodeLabel": "Start at Wave 1",
      "currentNodeMissing": false,
      "enrollmentKey": "__default__",
      "enrollmentStartedAt": "2026-01-01T00:00:00.000Z",
      "waitUntil": "2026-01-04T00:00:00.000Z",
      "lastUpdatedAt": "2026-01-01T00:00:00.000Z",
      "failedReason": null,
      "movedFromNodeId": null,
      "movedAt": null,
      "moveReason": null
    }
  ],
  "pagination": {
    "limit": 500,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false
  }
}

{
  "error": "Invalid status filter `paused`. Valid values: active, waiting, completed, failed, cancelled"
}

{
  "error": "Invalid API key"
}

{
  "error": "No companies found. Create a company first using the create_company tool."
}

{
  "error": "Sequence not found"
}

​List Sequence Enrollments

​Request

​Exporting the full list

​Response fields

​Diagnosing a failing step

​Responses

List Sequence Enrollments

Request

Exporting the full list

Response fields

Diagnosing a failing step

Responses