> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Audience Enrollments

> List and poll background audience enrollment runs

Recent audience enrollment runs for a sequence, newest first. Poll a single run with `GET /api/v1/sequences/{sequenceId}/audience-enrollments/{runId}` while its `status` is `queued` or `running`.

## Request

<ParamField path="sequenceId" type="string" required>
  Sequence ID.
</ParamField>

<ParamField query="limit" type="integer">
  Runs to return, 1 to 100. Defaults to 20.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/sequences/seq_abc123/audience-enrollments?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Poll one run:

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/sequences/seq_abc123/audience-enrollments/aer_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

Each run reports `status` (`queued`, `running`, `completed`, `cancelled`, `failed`), `estimatedCount` (audience size when the run started; `0` for incremental `auto_enroll` runs, which only scan recent joiners), `processedCount` (subscribers scanned so far), `enrolledCount`, `skippedCount` (matching contacts already in the sequence), `error`, `scheduledFor` (set while a queued run waits for its start time), `source` (`api`, `dashboard`, `cli`, or `auto_enroll` for runs the keep-enrolling sync starts), and the `createdAt`, `startedAt`, `completedAt`, and `cancelRequestedAt` timestamps.

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "audienceEnrollments": [
      {
        "id": "aer_abc123",
        "sequenceId": "seq_abc123",
        "status": "running",
        "audience": { "type": "all" },
        "targetNodeId": "node_delay_1",
        "estimatedCount": 12000,
        "processedCount": 4000,
        "enrolledCount": 3800,
        "skippedCount": 200,
        "source": "dashboard",
        "error": null,
        "createdAt": "2026-11-01T10:00:00.000Z",
        "startedAt": "2026-11-01T10:00:02.000Z",
        "completedAt": null,
        "cancelRequestedAt": null
      }
    ]
  }
  ```

  ```json 200 (single run) theme={null}
  {
    "success": true,
    "audienceEnrollment": {
      "id": "aer_abc123",
      "sequenceId": "seq_abc123",
      "status": "completed",
      "audience": { "type": "all" },
      "targetNodeId": "node_delay_1",
      "estimatedCount": 12000,
      "processedCount": 12400,
      "enrolledCount": 11800,
      "skippedCount": 200,
      "source": "dashboard",
      "error": null,
      "createdAt": "2026-11-01T10:00:00.000Z",
      "startedAt": "2026-11-01T10:00:02.000Z",
      "completedAt": "2026-11-01T10:03:40.000Z",
      "cancelRequestedAt": null
    }
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Audience enrollment not found"
  }
  ```
</ResponseExample>