> ## 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.

# Get a sequence

> Fetches a single sequence by `id`. Use this when you need the current schedule, the `active` / `repeat` / `hold` flags, the configured `email_address` and `email_template_id`, or `exclude_subscriber_sources` for a known sequence — for example, to confirm settings before adding subscribers or to render an editor.

For the individual emails inside the sequence, use [List sequence emails](/api-reference/sequence-emails/list-sequence-emails). For the sequence model and field semantics, see [Create a sequence](/api-reference/sequences/create-a-sequence).



## OpenAPI

````yaml /api-reference/v4.json get /v4/sequences/{id}
openapi: 3.0.3
info:
  title: Kit API
  version: '4.0'
servers:
  - url: https://api.kit.com
security: []
paths:
  /v4/sequences/{id}:
    get:
      tags:
        - Sequences
      summary: Get a sequence
      description: >-
        Fetches a single sequence by `id`. Use this when you need the current
        schedule, the `active` / `repeat` / `hold` flags, the configured
        `email_address` and `email_template_id`, or `exclude_subscriber_sources`
        for a known sequence — for example, to confirm settings before adding
        subscribers or to render an editor.


        For the individual emails inside the sequence, use [List sequence
        emails](/api-reference/sequence-emails/list-sequence-emails). For the
        sequence model and field semantics, see [Create a
        sequence](/api-reference/sequences/create-a-sequence).
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
          example: 23
      responses:
        '200':
          description: Returns the sequence details
          content:
            application/json:
              schema:
                type: object
                properties:
                  sequence:
                    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: {}
                    required:
                      - id
                      - name
                      - hold
                      - repeat
                      - created_at
                      - updated_at
                      - email_address
                      - email_template_id
                      - send_days
                      - send_hour
                      - time_zone
                      - active
                      - exclude_subscriber_sources
                required:
                  - sequence
              example:
                sequence:
                  id: 22
                  name: Welcome 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
                  send_days:
                    - monday
                    - tuesday
                    - wednesday
                    - thursday
                    - friday
                    - saturday
                    - sunday
                  send_hour: 11
                  time_zone: America/New_York
                  active: true
                  exclude_subscriber_sources: []
        '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
        '404':
          description: Returns a 404 when the provided id does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: string
                required:
                  - errors
              example:
                errors:
                  - Not Found
      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

````