Get sequence audience

Get a hydrated sequence audience with pagination and an optional enrollment status filter.

GET/api/sequences/{sequence_id}/audience

HTTP referenceScope authenticated user sessionUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This route currently requires an authenticated user session. Developer API keys are blocked by the backend for this route.

Path parameters

sequence_idrequired
string
Sequence ID.

Name	Type	Description
sequence_idrequired	string	Sequence ID.

Query parameters

limit · optional
integer
Number of records to return (1-200). Defaults to 50.
offset · optional
integer
Offset for pagination. Defaults to 0.
status · optional
string
Filter by enrollment status (e.g. active, paused, completed).

Name	Type	Description
limit	integer	Number of records to return (1-200). Defaults to 50.
offset	integer	Offset for pagination. Defaults to 0.
status	string	Filter by enrollment status (e.g. active, paused, completed).

Errors

Status	Meaning
401	Missing or invalid user session.
403	Developer API keys are blocked for this session-only route.
404	Sequence not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/sequences/67c4a4f7b4dd8f2d4999f014/audience?limit=50&status=active" \
    -H "Authorization: Bearer <user_session_token>"

Response example

json

{
    "sequence": {
      "id": "67c4a4f7b4dd8f2d4999f014",
      "name": "Outbound v1",
      "status": "ACTIVE",
      "steps": [],
      "createdAt": "2026-09-01T12:00:00Z",
      "updatedAt": "2026-09-20T12:00:00Z"
    },
    "audience": [
      {
        "enrollmentId": "67c4b2dcb4dd8f2d4999f200",
        "leadId": "67c4b113b4dd8f2d4999f0f1",
        "status": "active",
        "nextRunAt": "2026-09-28T13:00:00Z",
        "variables": { "first_name": "Ada" },
        "missingRequired": [],
        "variableMap": {},
        "researchTableId": null,
        "researchRowId": null,
        "researchContext": null,
        "researchValues": {},
        "aiResearchFavorites": [],
        "lead": { "id": "67c4b113b4dd8f2d4999f0f1", "first_name": "Ada", "last_name": "Lovelace" },
        "createdAt": "2026-09-20T12:00:00Z",
        "updatedAt": "2026-09-27T12:00:00Z"
      }
    ],
    "total": 150,
    "limit": 50,
    "offset": 0,
    "meta": { "generated_at": "2026-09-27T12:00:00Z" }
  }