---
title: "List sequences"
method: GET
path: "/v4/sequences"
tags: ["Sequences"]
---

# List sequences

`GET /v4/sequences`

Returns every sequence on the account. A sequence is a self-contained set of automated emails — subscribers join, then receive each email in order, governed by per-email `delay_value` / `delay_unit` and the sequence's overall `send_days`, `send_hour`, and `time_zone` schedule.

Each entry carries the schedule defaults plus three behavioural toggles: `active` (whether the sequence is delivering), `repeat` (whether subscribers can re-enter), and `hold` (whether subscribers stay active after receiving every published email — an evergreen pattern). See [Create a sequence](/api-reference/sequences/create-a-sequence) for the full sequence model.

Once you have a sequence's `id`, [List sequence emails](/api-reference/sequence-emails/list-sequence-emails) returns the individual emails inside it.

For end-user context on how creators build sequences, see the help articles on [creating and sending a sequence](https://help.kit.com/en/articles/2502629-creating-and-sending-a-sequence-in-kit) and [evergreen content](https://help.kit.com/en/articles/2502575-what-is-evergreen-content).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown
- `include` string

## Response `200`

Returns a paginated list of all sequences for your account

- object
  - `sequences` object[], required
    - `id` integer, required
    - `name` string, required
    - `hold` boolean, required
    - `repeat` boolean, required
    - `created_at` string, required
    - `updated_at` string
    - `email_address` unknown
    - `email_template_id` unknown
    - `send_days` string[]
    - `send_hour` integer
    - `time_zone` string
    - `active` boolean
    - `exclude_subscriber_sources` unknown[]
      - unknown
    - `email_count` integer
    - `subscriber_count` integer
    - `stats` object — Returned only when `include` contains `stats`. Performance stats matching the sequences dashboard. All deliverability fields (everything except `unsubscribers`) are null when the sequence has no deliverability data.
      - `unsubscribers` integer — Number of subscribers who have unsubscribed from (cancelled) this sequence. Reflects current subscription state (distinct from the email-event `email_unsubscribes` count).
      - `recipients` integer, nullable — Number of emails sent across the sequence. Denominator for the rate fields.
      - `opens` integer, nullable — Number of sent emails that were opened.
      - `clicks` integer, nullable — Number of sent emails that had a link clicked.
      - `email_unsubscribes` integer, nullable — Number of unsubscribe events on emails sent by this sequence (email-level events, not current subscription state).
      - `bounces` integer, nullable — Number of sent emails that bounced.
      - `complaints` integer, nullable — Number of sent emails that were marked as spam.
      - `open_rate` number, nullable — Percentage of sent emails that were opened.
      - `click_rate` number, nullable — Percentage of sent emails that had a link clicked.
      - `click_to_open_rate` number, nullable — Percentage of opened emails that had a link clicked.
      - `unsubscribe_rate` number, nullable — Percentage of sent emails that resulted in an unsubscribe.
      - `bounce_rate` number, nullable — Percentage of sent emails that bounced.
      - `complaint_rate` number, nullable — Percentage of sent emails marked as spam.
  - `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

---

[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)