---
title: "List subscribers for a sequence"
method: GET
path: "/v4/sequences/{sequence_id}/subscribers"
tags: ["Sequences"]
---

# List subscribers for a sequence

`GET /v4/sequences/{sequence_id}/subscribers`

Returns a cursor-paginated list of subscribers in the sequence, each with an `added_at` timestamp for when they entered it. By default only `active` subscribers are returned — use `status` (`active`, `inactive`, `bounced`, `complained`, `cancelled`, or `all`) to widen the search.

Filter by when subscribers entered the sequence with `added_after`/`added_before`, or by when the subscriber record was created with `created_after`/`created_before`. To add a subscriber to the sequence, use [Add subscriber to sequence](/api-reference/sequences/add-subscriber-to-sequence).

## Path parameters

- `sequence_id` integer, required

## Query parameters

- `added_after` string, nullable
- `added_before` string, nullable
- `after` unknown
- `before` unknown
- `created_after` string, nullable
- `created_before` string, nullable
- `include_total_count` boolean
- `per_page` unknown
- `status` 'active' | 'inactive' | 'bounced' | 'complained' | 'cancelled' | 'all'

## Response `200`

Returns a paginated list of subscribers for the specified sequence

- object
  - `subscribers` object[], required
    - `id` integer, required
    - `first_name` string, nullable, required
    - `email_address` string, required
    - `state` 'active' | 'cancelled' | 'bounced' | 'complained' | 'inactive', required
    - `created_at` string, required
    - `added_at` string, required
    - `fields` object, required
      - `category` string, nullable, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `404` — Returns a 404 when the provided id does not exist

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/versions/0df0c90d12da/schema)