> ## 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 eligible expense categories for a benefit

> Retrieve the list of expense categories that are eligible for reimbursement
under a specific company benefit. This is essential for HSA, FSA, and HRA
benefits where specific expense types determine reimbursement eligibility.
Helps payroll providers understand which expenses employees can claim.




## OpenAPI

````yaml external-api-schema.yml get /v1/company-benefits/{company_benefit_id}/eligible-expense-categories
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/company-benefits/{company_benefit_id}/eligible-expense-categories:
    get:
      tags:
        - Company Benefits
      summary: List eligible expense categories for a benefit
      description: >
        Retrieve the list of expense categories that are eligible for
        reimbursement

        under a specific company benefit. This is essential for HSA, FSA, and
        HRA

        benefits where specific expense types determine reimbursement
        eligibility.

        Helps payroll providers understand which expenses employees can claim.
      operationId: list_company_benefit_eligible_expense_categories
      parameters:
        - in: path
          name: company_benefit_id
          schema:
            type: string
            format: uuid
          required: true
          description: Unique identifier for the company benefit
      responses:
        '200':
          description: List of eligible expense categories
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListCompanyBenefitEligibleExpenseCategoriesResponse
      security:
        - partnerApiKey: []
components:
  schemas:
    ListCompanyBenefitEligibleExpenseCategoriesResponse:
      type: object
      description: Response containing eligible expense categories for a benefit
      properties:
        eligible_expense_categories:
          type: array
          items:
            $ref: '#/components/schemas/CompanyBenefitEligibleExpenseCategory'
          description: List of eligible expense categories
      required:
        - eligible_expense_categories
    CompanyBenefitEligibleExpenseCategory:
      type: object
      description: Expense category eligible for reimbursement under a benefit
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the eligible expense category
        expense_category:
          $ref: '#/components/schemas/ExpenseCategory'
        expense_category_name:
          type: string
          description: Name of the expense category
        expense_category_description:
          type: string
          nullable: true
          description: Description of the expense category
        company_benefit_id:
          type: string
          format: uuid
          description: Company benefit that allows this expense category
        created:
          type: string
          format: date-time
          description: Creation timestamp
        updated:
          type: string
          format: date-time
          description: Last update timestamp
      required:
        - id
        - expense_category
        - expense_category_name
        - company_benefit_id
        - created
        - updated
    ExpenseCategory:
      type: object
      description: A category of eligible expenses for reimbursement
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the expense category
        name:
          type: string
          description: Name of the expense category (e.g., "Medical", "Dental", "Vision")
        description:
          type: string
          nullable: true
          description: Detailed description of what expenses are covered
        created:
          type: string
          format: date-time
          description: Creation timestamp
        updated:
          type: string
          format: date-time
          description: Last update timestamp
      required:
        - id
        - name
        - created
        - updated
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````