Skip to main content
GET
List enrollment runs
Returns the most recent enrollment runs for one sequence, newest first, including runs started in the Salesfinity app. Use it to show what is running now and what ran recently.
  • The response is a plain array of runs, not the data and pagination envelope that paged lists use.
  • limit sets how far back to look: 10 by default, at most 25. There is no page cursor.
  • Runs are deleted 7 days after they finish, so older ones are not listed.
  • A sequence that is not on your team returns an empty array.
Runs started in the app from a connected CRM have source.kind crm. Each run has the same shape as Get an enrollment run returns.

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

sequence
string
required

The sequence whose runs to list. Required: runs are always listed per sequence.

limit
number
default:10

How many runs to return, newest first. Default 10. Above 25 is treated as 25.

Required range: 1 <= x <= 25

Response

Success.

run_id
string

enroll_ followed by 24 hexadecimal characters.

Example:

"enroll_9c1f4e2a7b3d5c6e8f0a1b2c"

status
enum<string>

queued: waiting for a worker. fetching: reading the source; total is not known yet. running: enrolling. completed, failed and cancelled are final.

Available options:
queued,
fetching,
running,
completed,
failed,
cancelled
sequence
string

24-character hexadecimal id.

Example:

"507f1f77bcf86cd799439011"

total
integer

Everyone the source yielded, including rows that cannot be attempted. 0 until the source has been read.

processed
integer

How many of total have been dealt with, enrolled or skipped. Progress is processed out of total.

enrolled
integer

People enrolled, including those held for approval.

skipped_count
integer

People not enrolled: refused by a check, or not attemptable (no email or LinkedIn handle, or past the 5,000 cap).

held_count
integer

Enrolled people a rule is holding for approval. Part of enrolled.

truncated
boolean

The source had more than 5,000 usable people; only the first 5,000 were considered.

sample_skipped
object[]

Up to 50 skipped people, each with the reason. Every refusal is also on the sequence's refusals list, except rows that could not be attempted.

error
string | null

Why the run failed or stopped early. Absent otherwise.

finished_at
string<date-time> | null

When the run reached a final status. Absent while it is in progress.

source
object

What the run was pointed at. A run started from a preview keeps the preview's source and adds preview_id. Runs started in the Salesfinity app from a connected CRM have kind crm and also carry provider, scope and list_id.

cancel_requested
boolean

A cancel has been asked for. The run stops at its next check, and status changes when it does.

created_at
string<date-time>

When the run was started.