> ## 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 upcoming benefit plans for a company

> Retrieve benefit plans that will become active in future periods.
Useful for open enrollment planning and preparation.




## OpenAPI

````yaml external-api-schema.yml get /v1/companies/{company_id}/benefits/upcoming
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/companies/{company_id}/benefits/upcoming:
    get:
      tags:
        - Company Benefits
      summary: List upcoming benefit plans for a company
      description: |
        Retrieve benefit plans that will become active in future periods.
        Useful for open enrollment planning and preparation.
      operationId: list_upcoming_company_benefits
      parameters:
        - in: path
          name: company_id
          schema:
            type: string
            format: uuid
          required: true
          description: Unique identifier for the company
      responses:
        '200':
          description: List of upcoming company benefits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUpcomingCompanyBenefitsResponse'
      security:
        - partnerApiKey: []
components:
  schemas:
    ListUpcomingCompanyBenefitsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CompanyBenefit'
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
    CompanyBenefit:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the benefit plan
        benefit_name:
          type: string
          description: >-
            Name of the benefit (e.g., "Individual Coverage Health Reimbursement
            Arrangement")
        benefit_code:
          type: string
          description: Benefit type code
        benefit_type:
          type: string
          description: Category of benefit
        plan_year_start:
          type: string
          format: date
          description: Start date of the plan year
        plan_year_end:
          type: string
          format: date
          description: End date of the plan year
        enrollment_start:
          type: string
          format: date
          description: Enrollment period start date
        enrollment_end:
          type: string
          format: date
          description: Enrollment period end date
        is_active:
          type: boolean
          description: Whether the benefit is currently active
    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
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````