> ## Documentation Index > Fetch the complete documentation index at: https://developers.kit.com/llms.txt > Use this file to discover all available pages before exploring further. # List 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). ## OpenAPI ````yaml /api-reference/v4.json get /v4/sequences openapi: 3.0.3 info: title: Kit API version: '4.0' servers: - url: https://api.kit.com security: [] paths: /v4/sequences: get: tags: - Sequences summary: List sequences description: >- 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). parameters: - name: after description: To fetch next page of results, use `?after=` in: query required: false schema: nullable: true - name: before description: To fetch previous page of results, use `?before=` in: query required: false schema: nullable: true - name: include_total_count description: >- Set to `true` to include the `total_count` in the response. This option can cause slow responses; if paging through results, request it only on the first page and reuse the value for subsequent pages. in: query required: false schema: type: boolean example: false - name: per_page description: Number of results per page. Default 500, maximum 1000. in: query required: false schema: nullable: true - name: include in: query required: false schema: type: string example: stats description: >- Comma-separated list of additional data to include on each sequence. Valid options: `stats`. `stats` adds a `stats` object with deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes) plus the unsubscriber count, matching the numbers shown on the sequences dashboard. responses: '200': description: Returns a paginated list of all sequences for your account content: application/json: schema: type: object properties: sequences: type: array items: type: object properties: id: type: integer name: type: string hold: type: boolean repeat: type: boolean created_at: type: string updated_at: type: string email_address: nullable: true email_template_id: nullable: true send_days: type: array items: type: string send_hour: type: integer time_zone: type: string active: type: boolean exclude_subscriber_sources: type: array items: {} email_count: type: integer subscriber_count: type: integer stats: type: object description: >- 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. properties: unsubscribers: type: integer description: >- Number of subscribers who have unsubscribed from (cancelled) this sequence. Reflects current subscription state (distinct from the email-event `email_unsubscribes` count). recipients: type: integer nullable: true description: >- Number of emails sent across the sequence. Denominator for the rate fields. opens: type: integer nullable: true description: Number of sent emails that were opened. clicks: type: integer nullable: true description: Number of sent emails that had a link clicked. email_unsubscribes: type: integer nullable: true description: >- Number of unsubscribe events on emails sent by this sequence (email-level events, not current subscription state). bounces: type: integer nullable: true description: Number of sent emails that bounced. complaints: type: integer nullable: true description: Number of sent emails that were marked as spam. open_rate: type: number nullable: true description: Percentage of sent emails that were opened. click_rate: type: number nullable: true description: >- Percentage of sent emails that had a link clicked. click_to_open_rate: type: number nullable: true description: >- Percentage of opened emails that had a link clicked. unsubscribe_rate: type: number nullable: true description: >- Percentage of sent emails that resulted in an unsubscribe. bounce_rate: type: number nullable: true description: Percentage of sent emails that bounced. complaint_rate: type: number nullable: true description: Percentage of sent emails marked as spam. required: - id - name - hold - repeat - created_at pagination: type: object properties: has_previous_page: type: boolean has_next_page: type: boolean start_cursor: type: string end_cursor: type: string per_page: type: integer required: - has_previous_page - has_next_page - start_cursor - end_cursor - per_page required: - sequences - pagination example: sequences: - id: 1 name: Evergreen sequence hold: false repeat: false created_at: '2023-02-17T11:43:55Z' updated_at: '2023-02-17T11:43:55Z' email_address: null email_template_id: null email_count: 0 subscriber_count: 0 send_days: - monday - tuesday - wednesday - thursday - friday - saturday - sunday send_hour: 11 time_zone: America/New_York active: true exclude_subscriber_sources: [] pagination: has_previous_page: false has_next_page: false start_cursor: WzFd end_cursor: WzFd per_page: 500 '401': description: Returns a 401 if the token and/or account cannot be authenticated content: application/json: schema: type: object properties: errors: type: array items: type: string required: - errors example: errors: - The access token is invalid security: - API Key: [] - OAuth2: [] components: securitySchemes: API Key: description: Authenticate API requests via an API Key type: apiKey in: header name: X-Kit-Api-Key OAuth2: description: Authenticate API requests via an OAuth token type: oauth2 flows: authorizationCode: authorizationUrl: https://api.kit.com/v4/oauth/authorize tokenUrl: https://api.kit.com/v4/oauth/token refreshUrl: https://api.kit.com/v4/oauth/token scopes: read: Read access to Kit API v4 write: Write access to Kit API v4 ````