> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifygtm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get enrollment step

> Retrieve one enrollment step and its current email copy.

## Overview

Retrieve one step of an enrollment by its ID. For email steps, `email` contains
the current copy and its `version_id`. Read the step before
[updating its copy](/developers/api/sequences/enrollments/update-step) so your
edit starts from the latest version.

Get step IDs from
[List enrollment steps](/developers/api/sequences/enrollments/list-steps).


## OpenAPI

````yaml GET /sequences/v1/enrollment-steps/{id}
openapi: 3.1.0
info:
  title: Unify Sequences API
  summary: Interact with sequences and sequence enrollments within the Unify platform.
  version: '1'
  termsOfService: https://www.unifygtm.com/legal/terms-and-conditions
  contact:
    name: Unify Support
    url: https://www.unifygtm.com/support
    email: support@unifygtm.com
servers:
  - url: https://api.unifygtm.com
    variables: {}
security:
  - ApiKeyAuth: []
tags:
  - name: Sequences
  - name: Sequence Enrollment Steps
  - name: Sequence Enrollments
paths:
  /sequences/v1/enrollment-steps/{id}:
    get:
      tags:
        - Sequences
        - Sequence Enrollment Steps
      description: |-
        Get a single enrollment step by its ID, including the current email copy
        for email steps.
      operationId: get_sequence_enrollment_step
      parameters:
        - name: id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/uuid'
      responses:
        '200':
          description: Response returned when fetching an enrollment step.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEnrollmentStepResponse'
        '400':
          description: Response for any operation that results in a bad request error.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                properties:
                  status:
                    type: string
                    enum:
                      - bad_request
                  errors:
                    type: array
                    items:
                      $ref: '#/components/schemas/UResponses.BadRequestError'
                  message:
                    type: string
                description: >-
                  Response for any operation that results in a bad request
                  error.
        '401':
          description: Response for any operation that results in an unauthorized error.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - unauthorized
                  message:
                    type: string
                description: >-
                  Response for any operation that results in an unauthorized
                  error.
        '404':
          description: Response returned when an enrollment step cannot be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnrollmentStepNotFoundResponse'
        '429':
          description: Response for any operation that exceeds a rate limit.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - rate_limited
                  message:
                    type: string
                description: Response for any operation that exceeds a rate limit.
        '500':
          description: Response for any operation that results in an internal server error.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                description: >-
                  Response for any operation that results in an internal server
                  error.
components:
  schemas:
    uuid:
      type: string
      format: uuid
      description: String UUID value.
    GetEnrollmentStepResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/EnrollmentStep'
      description: Response returned when fetching an enrollment step.
    UResponses.BadRequestError:
      type: object
      required:
        - code
      properties:
        code:
          type: string
        path:
          type: array
          items:
            anyOf:
              - type: string
              - type: integer
        object_api_name:
          type: string
        attribute_api_name:
          type: string
      allOf:
        - type: object
          unevaluatedProperties: {}
      description: Validation error detail returned for bad request responses.
    EnrollmentStepNotFoundResponse:
      type: object
      allOf:
        - type: object
          required:
            - status
            - message
          properties:
            status:
              type: string
              enum:
                - not_found
            message:
              type: string
          description: Response for any operation that results in a not found error.
      description: Response returned when an enrollment step cannot be found.
    EnrollmentStep:
      type: object
      required:
        - id
        - created_at
        - updated_at
        - enrollment_id
        - sequence_id
        - step_id
        - type
        - status
        - step_number
        - is_blocked
        - is_bounced
        - is_canceled
        - is_opted_out
        - is_paused
        - is_replied
        - started_at
        - ended_at
        - email
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        created_at:
          $ref: '#/components/schemas/datetime'
        updated_at:
          $ref: '#/components/schemas/datetime'
        enrollment_id:
          $ref: '#/components/schemas/uuid'
        sequence_id:
          $ref: '#/components/schemas/uuid'
        step_id:
          $ref: '#/components/schemas/uuid'
          description: ID of the sequence step this enrollment step was created from.
        type:
          $ref: '#/components/schemas/SequenceEnrollmentStepType'
        status:
          $ref: '#/components/schemas/SequenceEnrollmentStepStatus'
        step_number:
          anyOf:
            - type: integer
            - type: 'null'
          minimum: 1
          description: >-
            Position of the step in the enrollment, starting at 1. Null until
            the

            step is expected to run or has finished.
        is_blocked:
          type: boolean
        is_bounced:
          type: boolean
        is_canceled:
          type: boolean
        is_opted_out:
          type: boolean
        is_paused:
          type: boolean
        is_replied:
          type: boolean
        started_at:
          anyOf:
            - $ref: '#/components/schemas/datetime'
            - type: 'null'
        ended_at:
          anyOf:
            - $ref: '#/components/schemas/datetime'
            - type: 'null'
        email:
          anyOf:
            - $ref: '#/components/schemas/EnrollmentStepEmail'
            - type: 'null'
          description: Email copy for email steps. Null for other step types.
      description: One step of a person's enrollment in a sequence.
    datetime:
      type: string
      format: date-time
      description: String value representing an RFC 3339 datetime.
    SequenceEnrollmentStepType:
      type: string
      enum:
        - AUTOMATIC_EMAIL
        - MANUAL_EMAIL
        - ACTION_ITEM
        - ZAPIER
        - PHONE_CALL
        - MANUAL_LINKEDIN_PROFILE_VIEW
        - MANUAL_LINKEDIN_CONNECTION
        - MANUAL_LINKEDIN_MESSAGE
      description: Type of a sequence enrollment step.
    SequenceEnrollmentStepStatus:
      type: string
      enum:
        - NOT_STARTED
        - SCHEDULED
        - PENDING
        - FINISHED
        - CANCELED
        - ERRORED
        - UNREACHABLE
      description: Status of an individual sequence enrollment step.
    EnrollmentStepEmail:
      type: object
      required:
        - version_id
        - subject
        - fallback_subject
        - body
        - is_ready
        - is_edited
        - is_root_message
        - is_blocked
        - scheduled_send_at
        - sent_at
      properties:
        version_id:
          $ref: '#/components/schemas/uuid'
          description: >-
            ID of the current version of the copy. Changes every time the copy
            is

            updated.
        subject:
          anyOf:
            - type: string
            - type: 'null'
        fallback_subject:
          anyOf:
            - type: string
            - type: 'null'
          description: |-
            Subject used at send time when `subject` still contains unresolved
            template variables.
        body:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            HTML body of the email. Template variables and snippets are kept as

            `{{ ... }}` tokens and are resolved at send time. Null while the
            copy is

            being prepared.
        is_ready:
          type: boolean
          description: >-
            False while template variables and snippets are still being
            resolved.

            The email is not sent until the copy is ready.
        is_edited:
          type: boolean
          description: True when the copy was changed after it was first generated.
        is_root_message:
          type: boolean
          description: >-
            True for the first email of a thread. Subjects can only be set on
            root

            messages. Replies reuse the thread's subject.
        is_blocked:
          type: boolean
          description: |-
            True when the email cannot be sent in its current state, for example
            because of unresolved template variables or a mailbox problem.
        scheduled_send_at:
          anyOf:
            - $ref: '#/components/schemas/datetime'
            - type: 'null'
        sent_at:
          anyOf:
            - $ref: '#/components/schemas/datetime'
            - type: 'null'
      description: Email copy prepared for one enrollment step.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.