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

# List open enrollment benefits for a member

> Retrieve available benefit enrollment options during open enrollment periods.
Essential for payroll providers to understand which benefits employees
can enroll in during open enrollment windows.




## OpenAPI

````yaml external-api-schema.yml get /v1/members/{member_id}/open-enrollment-benefits
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/members/{member_id}/open-enrollment-benefits:
    get:
      tags:
        - Member Benefits
      summary: List open enrollment benefits for a member
      description: >
        Retrieve available benefit enrollment options during open enrollment
        periods.

        Essential for payroll providers to understand which benefits employees

        can enroll in during open enrollment windows.
      operationId: list_open_company_benefit_enrollments_for_member
      parameters:
        - in: path
          name: member_id
          schema:
            type: string
            format: uuid
          required: true
          description: Unique identifier for the member
      responses:
        '200':
          description: List of open enrollment benefit options
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListOpenCompanyBenefitEnrollmentsForMemberResponse
      security:
        - partnerApiKey: []
components:
  schemas:
    ListOpenCompanyBenefitEnrollmentsForMemberResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/OpenBenefitEnrollment'
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
    OpenBenefitEnrollment:
      type: object
      properties:
        enrollment_id:
          type: string
          format: uuid
          description: Enrollment identifier
        benefit_name:
          type: string
          description: Benefit name
        benefit_type:
          type: string
          description: Benefit type
        enrollment_deadline:
          type: string
          format: date
          description: Enrollment deadline
        available_plans:
          type: array
          items:
            $ref: '#/components/schemas/CompanyBenefitPlanDTO'
          description: Available plan options
      required:
        - enrollment_id
        - benefit_name
        - benefit_type
        - enrollment_deadline
        - available_plans
    PaginationInfo:
      type: object
      properties:
        page:
          type: integer
          description: Current page number
        limit:
          type: integer
          description: Number of items per page
        total_count:
          type: integer
          description: Total number of items
        total_pages:
          type: integer
          description: Total number of pages
    CompanyBenefitPlanDTO:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Plan identifier
        company_id:
          type: string
          format: uuid
          description: Company identifier
        name:
          type: string
          description: Plan name
        level:
          type: integer
          description: Plan level/tier
        employee_enrollment_count:
          type: integer
          nullable: true
          description: Number of employees enrolled
        dependent_enrollment_count:
          type: integer
          nullable: true
          description: Number of dependents enrolled
        tier_costs:
          type: array
          items:
            $ref: '#/components/schemas/CompanyBenefitPlanTierCostDTO'
          description: Cost information by tier
        min_tier_cost:
          type: integer
          description: Minimum tier cost in cents
        max_dependent_cost:
          type: integer
          description: Maximum dependent cost in cents
        vitable_only_in:
          type: boolean
          description: Whether plan is Vitable-only
      required:
        - id
        - company_id
        - name
        - level
        - tier_costs
        - min_tier_cost
        - max_dependent_cost
        - vitable_only_in
    CompanyBenefitPlanTierCostDTO:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Tier cost identifier
        benefit_plan_tier_name:
          type: string
          description: Tier name
        cost:
          type: integer
          description: Employee cost in cents
        cost_per_dependent:
          type: integer
          description: Per-dependent cost in cents
        dependents_required_in:
          type: boolean
          description: Whether dependents are required
        spouse_required_in:
          type: boolean
          description: Whether spouse is required
      required:
        - id
        - benefit_plan_tier_name
        - cost
        - cost_per_dependent
        - dependents_required_in
        - spouse_required_in
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````