Skip to content
Vitable Docs Vitable Docs Vitable Docs
API Reference

Enrollments

Manage benefit enrollments and elections for employees

Get enrollment details
client.enrollments.retrieve(stringenrollmentID, RequestOptionsoptions?): EnrollmentRetrieveResponse { data }
GET/v1/enrollments/{enrollment_id}
Reissue an enrollment
client.enrollments.reissue(stringenrollmentID, EnrollmentReissueParams { qualifying_life_event_id, reason, ticket_number } body?, RequestOptionsoptions?): EnrollmentReissueResponse { data }
POST/v1/enrollments/{enrollment_id}/reissue
Terminate an enrollment
client.enrollments.terminate(stringenrollmentID, EnrollmentTerminateParams { qualifying_life_event_id, reason, ticket_number } body?, RequestOptionsoptions?): void
POST/v1/enrollments/{enrollment_id}/terminate
ModelsExpand Collapse
Enrollment { id, answered_at, benefit, 10 more }

One enrollment as it appears in a list row.

id: string

Unique enrollment identifier (enrl_*)

answered_at: string | null

When the employee enrolled or waived

formatdate-time
benefit: Benefit { id, category, name, product_code }

Nested benefit product summary

id: string

Benefit product ID (bprd_*)

category: "Medical" | "Dental" | "Vision" | "Hospital"
  • Medical - Medical
  • Dental - Dental
  • Vision - Vision
  • Hospital - Hospital
One of the following:
"Medical"
"Dental"
"Vision"
"Hospital"
name: string

Display name of the benefit product

product_code: "EBA" | "VPC" | "VPC_CORE" | 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
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"
coverage_end: string | null

Coverage period end date

formatdate
coverage_start: string

Coverage period start date

formatdate
created_at: string

When the enrollment was created

formatdate-time
employee_deduction_in_cents: number | null

Employee monthly payroll deduction in cents

employee_id: string

Employee ID (empl_*)

employer_contribution_in_cents: number | null

Employer monthly contribution in cents

employer_id: string

Employer ID (empr_*)

status: EnrollmentStatus
  • pending - Pending
  • enrolled - Enrolled
  • waived - Waived
  • inactive - Inactive
One of the following:
"pending"
"enrolled"
"waived"
"inactive"
terminated_at: string | null

When coverage was terminated

formatdate-time
updated_at: string

When the enrollment was last updated

formatdate-time
EnrollmentStatus = "pending" | "enrolled" | "waived" | "inactive"
  • pending - Pending
  • enrolled - Enrolled
  • waived - Waived
  • inactive - Inactive
One of the following:
"pending"
"enrolled"
"waived"
"inactive"
EnrollmentRetrieveResponse { data }

Response containing a single enrollment resource.

data: Data { id, answered_at, benefit, 11 more }

A single enrollment, including the enrolled plan’s documents.

The plan documents are resolved one enrollment at a time and are therefore not part of the list row.

id: string

Unique enrollment identifier (enrl_*)

answered_at: string | null

When the employee enrolled or waived

formatdate-time
benefit: Benefit { id, category, name, product_code }

Nested benefit product summary

id: string

Benefit product ID (bprd_*)

category: "Medical" | "Dental" | "Vision" | "Hospital"
  • Medical - Medical
  • Dental - Dental
  • Vision - Vision
  • Hospital - Hospital
One of the following:
"Medical"
"Dental"
"Vision"
"Hospital"
name: string

Display name of the benefit product

product_code: "EBA" | "VPC" | "VPC_CORE" | 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
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"
coverage_end: string | null

Coverage period end date

formatdate
coverage_start: string

Coverage period start date

formatdate
created_at: string

When the enrollment was created

formatdate-time
employee_deduction_in_cents: number | null

Employee monthly payroll deduction in cents

employee_id: string

Employee ID (empl_*)

employer_contribution_in_cents: number | null

Employer monthly contribution in cents

employer_id: string

Employer ID (empr_*)

status: EnrollmentStatus
  • pending - Pending
  • enrolled - Enrolled
  • waived - Waived
  • inactive - Inactive
One of the following:
"pending"
"enrolled"
"waived"
"inactive"
terminated_at: string | null

When coverage was terminated

formatdate-time
updated_at: string

When the enrollment was last updated

formatdate-time
sbc_url?: string | null

Summary of Benefits and Coverage (SBC) document URL for the enrolled plan; null when not on file. Only individual (ICHRA) plans carry an SBC — group plans have no SBC on record and always resolve to null.

EnrollmentReissueResponse { data }

Response containing a single reissue enrollment resource.

data: Data { enrollment_id }
enrollment_id: string

Opaque identifier for the new unanswered enrollment