# Vitable Health Docs

## Docs

- [Create benefit eligibility policy](https://beta-docs.vitablehealth.com/api-reference/benefit-eligibility/create-benefit-eligibility-policy.md): Create a new benefit eligibility policy for a company. This allows payroll providers to configure eligibility rules determining which employees qualify for benefits based on employment classification and waiting periods.
- [List employee benefit eligibilities](https://beta-docs.vitablehealth.com/api-reference/benefit-eligibility/list-employee-benefit-eligibilities.md): Retrieve benefit eligibility information for employees. Helps payroll providers understand who is eligible for which benefits.
- [List enrollments for a specific benefit plan](https://beta-docs.vitablehealth.com/api-reference/benefit-enrollments/list-enrollments-for-a-specific-benefit-plan.md): Get all enrollments for a particular benefit plan year. Useful for generating enrollment reports and understanding participation rates.
- [Search benefit enrollments](https://beta-docs.vitablehealth.com/api-reference/benefit-enrollments/search-benefit-enrollments.md): Search and filter benefit enrollments across employees and benefit plans.
- [Configure company benefit](https://beta-docs.vitablehealth.com/api-reference/company-benefits/configure-company-benefit.md): Configure a company benefit with eligibility rules, tier costs, expense categories, and enrollment periods. This endpoint allows payroll providers to set up comprehensive benefit configurations including minimum premiums, eligibility criteria, and cost structures.
- [Get company benefit details](https://beta-docs.vitablehealth.com/api-reference/company-benefits/get-company-benefit-details.md): Retrieve detailed information about a specific company benefit. Provides comprehensive benefit details including plans, eligibility rules, expense categories, pricing, and configuration information.
- [List active benefit plans for a company](https://beta-docs.vitablehealth.com/api-reference/company-benefits/list-active-benefit-plans-for-a-company.md): Retrieve all currently active benefit plans available to a company. This is equivalent to "plan years" in benefit administration terminology. Used by payroll providers to understand what benefit options are available.
- [List eligible expense categories by benefit type](https://beta-docs.vitablehealth.com/api-reference/company-benefits/list-eligible-expense-categories-by-benefit-type.md): Retrieve expense categories that are eligible for reimbursement based on benefit type code. This endpoint provides the standard expense categories available for different types of benefits (HSA, FSA, HRA, etc.) rather than the specific categories configured for a particular company benefit plan. Use…
- [List eligible expense categories for a benefit](https://beta-docs.vitablehealth.com/api-reference/company-benefits/list-eligible-expense-categories-for-a-benefit.md): 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.
- [List upcoming benefit plans for a company](https://beta-docs.vitablehealth.com/api-reference/company-benefits/list-upcoming-benefit-plans-for-a-company.md): Retrieve benefit plans that will become active in future periods. Useful for open enrollment planning and preparation.
- [Search company benefits](https://beta-docs.vitablehealth.com/api-reference/company-benefits/search-company-benefits.md): Search and filter company benefits with various criteria. Allows payroll providers to find specific benefit plans based on status, configuration, and coverage periods for comprehensive benefit management.
- [Create a new employee](https://beta-docs.vitablehealth.com/api-reference/company-members/create-a-new-employee.md): Create a new employee record for a company. This endpoint allows payroll providers to add new employees to the system with complete demographic and employment information.
- [Get employee details](https://beta-docs.vitablehealth.com/api-reference/company-members/get-employee-details.md): Retrieve detailed information about a specific employee. Includes demographic information, employment details, and benefit eligibility.
- [List employees for a company](https://beta-docs.vitablehealth.com/api-reference/company-members/list-employees-for-a-company.md): Retrieve a list of employees (company members) with filtering options. This endpoint is essential for payroll providers to get employee rosters and understand benefit eligibility.
- [Terminate an employee](https://beta-docs.vitablehealth.com/api-reference/company-members/terminate-an-employee.md): Deactivate/terminate an employee by setting their termination date. This endpoint allows payroll providers to process employee terminations and ensures proper benefit enrollment termination handling.
- [Update employee information](https://beta-docs.vitablehealth.com/api-reference/company-members/update-employee-information.md): Update employee demographic and employment information. Commonly used when payroll providers receive updates from HRIS systems.
- [Elect benefit enrollments](https://beta-docs.vitablehealth.com/api-reference/enrollment-management/elect-benefit-enrollments.md): Process benefit enrollment elections for employees and their dependents. Allows payroll providers to submit enrollment choices, waive benefits, add dependents, and complete the enrollment process with electronic signatures.
- [Re-issue a benefit enrollment](https://beta-docs.vitablehealth.com/api-reference/enrollment-management/re-issue-a-benefit-enrollment.md): Re-issue an existing benefit enrollment, typically used when there are changes needed to enrollment details, updates to dependent information, or corrections to enrollment data. Requires administrative documentation and evidence notes for audit purposes.
- [Submit a qualifying life event](https://beta-docs.vitablehealth.com/api-reference/enrollment-management/submit-a-qualifying-life-event.md): 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.
- [Explore](https://beta-docs.vitablehealth.com/api-reference/index.md): Explore our APIs, please note these are all subject to change as they are still in active development.
- [List active benefit enrollments for an employee](https://beta-docs.vitablehealth.com/api-reference/member-benefits/list-active-benefit-enrollments-for-an-employee.md): Retrieve all active benefit enrollments for a specific employee. Critical for payroll providers to determine current coverage.
- [List open enrollment benefits for a member](https://beta-docs.vitablehealth.com/api-reference/member-benefits/list-open-enrollment-benefits-for-a-member.md): 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.
- [List pending benefit enrollments for a member](https://beta-docs.vitablehealth.com/api-reference/member-benefits/list-pending-benefit-enrollments-for-a-member.md): Retrieve pending benefit enrollments that require action or approval. Helps payroll providers track enrollment status and identify enrollments that need completion or processing.
- [List payroll deduction statements for a company](https://beta-docs.vitablehealth.com/api-reference/payroll-integration/list-payroll-deduction-statements-for-a-company.md): Retrieve payroll deduction statements for a company across all payroll periods. These statements contain detailed deduction amounts and downloadable files for payroll processing. Essential for payroll providers to access historical deduction data and change files.
- [Search marketplace plans](https://beta-docs.vitablehealth.com/api-reference/quoting/search-marketplace-plans.md): Search for health insurance marketplace plans based on location, applicants, and household information. This endpoint helps payroll providers and benefits administrators find available health plans for ICHRA (Individual Coverage HRA) implementations and employee plan selection.
- [Introduction](https://beta-docs.vitablehealth.com/getting-started/index.md): Welcome to the documentation hub for the Vitable Health API, the first all-in-one embedded benefit administration and care stack API platform.

## OpenAPI Specs

- [external-api-schema](https://beta-docs.vitablehealth.com/external-api-schema.yml)
- [openapi](https://beta-docs.vitablehealth.com/api-reference/openapi.json)

## Optional

- [Website](https://vitablehealth.com)
- [Blog](https://vitablehealth.com/blog)