Skip to content
Vitable Docs Vitable Docs Vitable Docs
Get started
API Reference

Benefit Products

List benefit products
get/v1/benefit-products
ModelsExpand Collapse
Category = "Medical" or "Dental" or "Vision" or "Hospital"
  • Medical - Medical
  • Dental - Dental
  • Vision - Vision
  • Hospital - Hospital
Accepts one of the following:
"Medical"
"Dental"
"Vision"
"Hospital"
ProductCode = "EBA" or "VPC" or "VPC_CORE" or 12 more
  • EBA - Eba Mec
  • VPC - Vpc Enhanced
  • VPC_CORE - Vpc Core
  • MEC - Vpc Mec
  • MEC2 - Mec2
  • MEC_PLUS - Mec Plus
  • MVP - Mvp
  • MVP2 - Mvp2
  • MVPSL - Mvpsl
  • MVPSL2 - Mvpsl2
  • VD - Dental
  • VV - Vision
  • ICHRA - Ichra
  • ICHRA_PREMIUM_PLUS - Ichra Premium Plus
  • ICHRA_REIMBURSEMENT_ONLY - Ichra Reimbursement Only
Accepts one of the following:
"EBA"
"VPC"
"VPC_CORE"
"MEC"
"MEC2"
"MEC_PLUS"
"MVP"
"MVP2"
"MVPSL"
"MVPSL2"
"VD"
"VV"
"ICHRA"
"ICHRA_PREMIUM_PLUS"
"ICHRA_REIMBURSEMENT_ONLY"

Benefit ProductsPlan Years

List plan years for benefit
get/v1/benefit-products/{benefit_product_id}/plan-years
Create new plan year
post/v1/benefit-products/{benefit_product_id}/plan-years
ModelsExpand Collapse
PlanYear = object { id, benefit_product_id, contribution_classes, 9 more }

Serializer for Plan Year entity in public API responses.

A Plan Year represents a benefit period configuration including coverage dates, open enrollment windows, available plans, and contribution structures.

id: string

Unique plan year identifier with 'plyr_' prefix

benefit_product_id: string

ID of the benefit product (bprd_*)

contribution_classes: array of object { id, employee_contribution_cents, employer_contribution_cents, 2 more }

List of contribution classes defining eligibility tiers and cost structures

id: string

Unique contribution class identifier

employee_contribution_cents: number

Employee's monthly contribution amount in cents

employer_contribution_cents: number

Employer's monthly contribution amount in cents

employment: string

Employment type for this contribution class (e.g., 'full_time', 'part_time')

family_status: CoverageTier
  • Unspecified - Unspecified
  • EE - Ee
  • ES - Es
  • EC - Ec
  • EF - Ef
Accepts one of the following:
"Unspecified"
"EE"
"ES"
"EC"
"EF"
coverage_end: string

Date when benefit coverage ends

formatdate
coverage_start: string

Date when benefit coverage begins

formatdate
created_at: string

Timestamp when the plan year was created

formatdate-time
employer_id: string

ID of the employer this plan year is for (empr_*)

open_enrollment_end_date: string

Date when open enrollment period ends

formatdate
open_enrollment_start_date: string

Date when open enrollment period begins

formatdate
plans: array of object { id, carrier_plan_id, monthly_premium_cents, 4 more }

List of insurance plans available in this plan year

id: string

Unique plan identifier with 'plan_' prefix

carrier_plan_id: string

Reference to the carrier's plan definition (cplan_*)

monthly_premium_cents: number

Base monthly premium in cents

name: string

Display name of the insurance plan

deductible_cents: optional number

Annual deductible amount in cents

out_of_pocket_max_cents: optional number

Annual out-of-pocket maximum in cents

tier: optional PlanTier
  • Bronze - Bronze
  • Silver - Silver
  • Gold - Gold
  • Platinum - Platinum
Accepts one of the following:
"Bronze"
"Silver"
"Gold"
"Platinum"
status: PlanYearStatus
  • draft - Draft
  • open_enrollment - Open Enrollment
  • active - Active
  • expired - Expired
Accepts one of the following:
"draft"
"open_enrollment"
"active"
"expired"
updated_at: string

Timestamp when the plan year was last updated

formatdate-time
PlanYearStatus = "draft" or "open_enrollment" or "active" or "expired"
  • draft - Draft
  • open_enrollment - Open Enrollment
  • active - Active
  • expired - Expired
Accepts one of the following:
"draft"
"open_enrollment"
"active"
"expired"