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

# List enrollments

> List sequence enrollments, optionally filtered by sequence, person, mailbox, status, enrolling play, or update time.



## OpenAPI

````yaml GET /enrollments
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/sequences/v1
    variables: {}
security:
  - ApiKeyAuth: []
tags:
  - name: Sequences
  - name: Sequence Enrollment Steps
  - name: Sequence Enrollments
paths:
  /enrollments:
    get:
      tags:
        - Sequences
        - Sequence Enrollments
      description: |-
        List sequence enrollments — each tracks one person's progress through a
        sequence along with reply, bounce, opt-out, and pause state.
      operationId: list_sequence_enrollments
      parameters:
        - name: cursor
          in: query
          required: false
          description: Opaque cursor returned by the previous page.
          schema:
            type: string
          explode: false
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
          explode: false
        - name: sequence_id
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/uuid'
          explode: false
        - name: person_id
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/uuid'
          explode: false
        - name: mailbox_id
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/uuid'
          explode: false
        - name: enrolled_by_play_id
          in: query
          required: false
          description: Filter to enrollments created by this play.
          schema:
            $ref: '#/components/schemas/uuid'
          explode: false
        - name: status
          in: query
          required: false
          description: Repeat `status` to filter by multiple enrollment statuses.
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SequenceEnrollmentStatus'
        - name: updated_after
          in: query
          required: false
          description: Inclusive lower bound on `updated_at`.
          schema:
            $ref: '#/components/schemas/datetime'
          explode: false
        - name: updated_before
          in: query
          required: false
          description: Inclusive upper bound on `updated_at`.
          schema:
            $ref: '#/components/schemas/datetime'
          explode: false
      responses:
        '200':
          description: Response returned when listing enrollments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEnrollmentsResponse'
        '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.
        '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.
    SequenceEnrollmentStatus:
      type: string
      enum:
        - DRAFT
        - IN_PROGRESS
        - FINISHED
      description: Status of a sequence enrollment.
    datetime:
      type: string
      format: date-time
      description: String value representing an RFC 3339 datetime.
    ListEnrollmentsResponse:
      type: object
      required:
        - enrollments
        - next_cursor
      properties:
        enrollments:
          type: array
          items:
            $ref: '#/components/schemas/Enrollment'
        next_cursor:
          type: string
          nullable: true
      description: Response returned when listing enrollments.
    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
          additionalProperties: {}
      description: Validation error detail returned for bad request responses.
    Enrollment:
      type: object
      required:
        - id
        - created_at
        - updated_at
        - sequence
        - person
        - mailbox
        - enrolled_by_play
        - reply_email_message
        - status
        - is_blocked
        - is_bounced
        - is_canceled
        - is_excluded
        - is_opted_out
        - is_paused
        - is_replied
        - started_at
        - ended_at
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        created_at:
          $ref: '#/components/schemas/datetime'
        updated_at:
          $ref: '#/components/schemas/datetime'
        sequence:
          $ref: '#/components/schemas/EnrollmentSequence'
        person:
          $ref: '#/components/schemas/EnrollmentPerson'
        mailbox:
          $ref: '#/components/schemas/EnrollmentMailbox'
        enrolled_by_play:
          type: object
          allOf:
            - $ref: '#/components/schemas/EnrollmentPlay'
          nullable: true
          description: The play that created the enrollment, if applicable.
        reply_email_message:
          type: object
          allOf:
            - $ref: '#/components/schemas/EnrollmentReplyEmailMessage'
          nullable: true
        status:
          $ref: '#/components/schemas/SequenceEnrollmentStatus'
        is_blocked:
          type: boolean
        is_bounced:
          type: boolean
        is_canceled:
          type: boolean
        is_excluded:
          type: boolean
        is_opted_out:
          type: boolean
        is_paused:
          type: boolean
        is_replied:
          type: boolean
        started_at:
          type: string
          allOf:
            - $ref: '#/components/schemas/datetime'
          nullable: true
        ended_at:
          type: string
          allOf:
            - $ref: '#/components/schemas/datetime'
          nullable: true
      description: A sequence enrollment.
      example:
        id: 0b2f4c1a-6d3e-4f8b-9a2c-5e7d1f3a8b6c
        created_at: '2026-07-01T15:04:05Z'
        updated_at: '2026-07-14T09:30:12Z'
        sequence:
          id: 7f3a9b2c-1e4d-4a6f-8c5b-2d9e0f7a4b1c
          name: Outbound — Warm Signups
          is_paused: false
        person:
          id: 6741cc39-b332-45a8-a439-75b69db998b1
          email: lead@example.com
          first_name: Lee
          last_name: Lead
          linkedin_url: null
        mailbox:
          id: 9b2a2761-3cbe-481f-8a1e-b24859c674f8
          email: rep@unifygtm.com
          display_name: Sam Rep
          is_paused: false
          is_unauthorized: false
        enrolled_by_play:
          id: de885595-2d9a-4fb9-ae30-25ef18b6219b
          name: New signup outreach
        reply_email_message:
          id: 1f3c0e2a-8b6d-4c2e-9f1a-2d4e6f8a0b1c
          subject: 'Re: Quick question'
          classifications:
            - id: 4a8b6c0d-2e1f-4a3b-8c5d-9e7f1a2b3c4d
              category: POSITIVE
          received_at: '2026-07-14T09:30:12Z'
        status: FINISHED
        is_blocked: false
        is_bounced: false
        is_canceled: false
        is_excluded: false
        is_opted_out: false
        is_paused: false
        is_replied: true
        started_at: '2026-07-01T15:04:05Z'
        ended_at: '2026-07-14T09:30:12Z'
    EnrollmentSequence:
      type: object
      required:
        - id
        - name
        - is_paused
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        name:
          type: string
        is_paused:
          type: boolean
      description: Sequence details embedded in enrollment responses.
    EnrollmentPerson:
      type: object
      required:
        - id
        - email
        - first_name
        - last_name
        - linkedin_url
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        email:
          $ref: '#/components/schemas/email'
        first_name:
          type: string
          nullable: true
        last_name:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
      description: Person details embedded in enrollment responses.
    EnrollmentMailbox:
      type: object
      required:
        - id
        - email
        - display_name
        - is_paused
        - is_unauthorized
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        email:
          $ref: '#/components/schemas/email'
        display_name:
          type: string
          nullable: true
        is_paused:
          type: boolean
        is_unauthorized:
          type: boolean
      description: Mailbox details embedded in enrollment responses.
    EnrollmentPlay:
      type: object
      required:
        - id
        - name
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        name:
          type: string
      description: Details of the play that created an enrollment.
    EnrollmentReplyEmailMessage:
      type: object
      required:
        - received_at
      properties:
        received_at:
          type: string
          allOf:
            - $ref: '#/components/schemas/datetime'
          nullable: true
      allOf:
        - $ref: '#/components/schemas/ReplyEmailMessage'
      description: Reply email message details embedded in enrollment responses.
    email:
      type: string
      format: email
      description: String value representing an email address.
    ReplyEmailMessage:
      type: object
      required:
        - id
        - subject
        - classifications
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        subject:
          type: string
          nullable: true
        classifications:
          type: array
          items:
            $ref: '#/components/schemas/ReplyEmailClassification'
      description: Reply email message details embedded in sequence API results.
    ReplyEmailClassification:
      type: object
      required:
        - id
        - category
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        category:
          $ref: '#/components/schemas/ReplyEmailClassificationCategory'
      description: Reply email classification details embedded in sequence API results.
    ReplyEmailClassificationCategory:
      type: string
      enum:
        - AUTOMATED
        - NEGATIVE
        - NEUTRAL
        - POSITIVE
      description: Reply classification category.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````