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

# Submit a qualifying life event

> Submit a qualifying life event (QLE) that allows employees to make benefit
changes outside of open enrollment periods. Common events include marriage,
divorce, birth of a child, or court orders. This creates a special enrollment
period for the affected employee.




## OpenAPI

````yaml external-api-schema.yml post /v1/external-qualifying-life-events/submission
openapi: 3.0.3
info:
  title: Vitable External Partner API
  version: 1.0.0
  description: >
    External API for Payroll Providers and PEO platforms to integrate with
    Vitable health plan products 

    for benefit administration. This API enables partner systems to manage
    benefit enrollment, 

    employee data, and plan information for their clients.


    Common integration scenarios:

    - Retrieve active benefit plans for employers

    - List enrolled employees for benefit periods  

    - Create and update employee records

    - Manage benefit enrollments and elections

    - Access enrollment status and eligibility information
servers:
  - url: https://api.vitablehealth.com
    description: Production server
  - url: https://api-staging.vitablehealth.com
    description: Staging server
security:
  - partnerApiKey: []
tags:
  - name: Company Benefits
    description: Benefit plans available to companies (plan years)
  - name: Company Members
    description: Employee management and information
  - name: Benefit Enrollments
    description: Employee benefit enrollment status and management
  - name: Member Benefits
    description: Individual employee benefit information
  - name: Benefit Eligibility
    description: Employee benefit eligibility information
  - name: Payroll Integration
    description: Payroll deduction and contribution calculations
  - name: Quoting
    description: Marketplace plan searches and insurance quotes
paths:
  /v1/external-qualifying-life-events/submission:
    post:
      tags:
        - Enrollment Management
      summary: Submit a qualifying life event
      description: >
        Submit a qualifying life event (QLE) that allows employees to make
        benefit

        changes outside of open enrollment periods. Common events include
        marriage,

        divorce, birth of a child, or court orders. This creates a special
        enrollment

        period for the affected employee.
      operationId: submit_pending_qualifying_life_event
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitPendingQualifyingLifeEventRequest'
      responses:
        '201':
          description: Qualifying life event submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitPendingQualifyingLifeEventResponse'
      security:
        - partnerApiKey: []
components:
  schemas:
    SubmitPendingQualifyingLifeEventRequest:
      type: object
      description: Request to submit a qualifying life event
      properties:
        event:
          $ref: '#/components/schemas/ExternalQualifyingLifeEventTypeEnum'
        other_event:
          type: string
          nullable: true
          maxLength: 128
          description: Description of other qualifying life event if event type is "Other"
      required:
        - event
    SubmitPendingQualifyingLifeEventResponse:
      type: object
      description: Response from submitting a qualifying life event
      properties:
        qle:
          $ref: '#/components/schemas/ExternalQualifyingLifeEvent'
      required:
        - qle
    ExternalQualifyingLifeEventTypeEnum:
      type: string
      enum:
        - Married
        - Divorced
        - New child
        - Court ordered
        - Other
      description: |
        Types of qualifying life events:
        * `Married` - Marriage
        * `Divorced` - Divorce or legal separation
        * `New child` - Birth or adoption of a child
        * `Court ordered` - Court-ordered coverage changes
        * `Other` - Other qualifying life event (requires description)
    ExternalQualifyingLifeEvent:
      type: object
      description: A qualifying life event that enables special enrollment periods
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the qualifying life event
        submitted_by_id:
          type: string
          format: uuid
          description: Member who submitted this QLE request
        submitted_by_full_name:
          type: string
          description: Full name of member who submitted the QLE
        event:
          $ref: '#/components/schemas/ExternalQualifyingLifeEventTypeEnum'
        other_event:
          type: string
          nullable: true
          description: Description of other QLE if event type is "Other"
        rejected_on:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when QLE was rejected (if applicable)
        accepted_on:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when QLE was accepted (if applicable)
        pending_in:
          type: boolean
          description: Whether the QLE is still pending review
        created:
          type: string
          format: date-time
          description: QLE creation timestamp
        updated:
          type: string
          format: date-time
          description: QLE last update timestamp
      required:
        - id
        - submitted_by_id
        - submitted_by_full_name
        - event
        - pending_in
        - created
        - updated
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````