# Enrollments

## Get enrollment details

`client.enrollments.retrieve(stringenrollmentID, RequestOptionsoptions?): EnrollmentRetrieveResponse`

**get** `/v1/enrollments/{enrollment_id}`

Retrieves detailed information for a specific enrollment by ID.

### Parameters

- `enrollmentID: string`

  Unique enrollment identifier (enrl_*)

### Returns

- `EnrollmentRetrieveResponse`

  Response containing a single enrollment resource.

  - `data: Enrollment`

    - `id: string`

      Unique enrollment identifier (enrl_*)

    - `answered_at: string | null`

      When the employee enrolled or waived

    - `benefit: Benefit`

      Nested benefit product summary

      - `id: string`

        Benefit product ID (bprd_*)

      - `category: "Medical" | "Dental" | "Vision" | "Hospital"`

        * `Medical` - Medical
        * `Dental` - Dental
        * `Vision` - Vision
        * `Hospital` - Hospital

        - `"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

        - `"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

    - `coverage_start: string`

      Coverage period start date

    - `created_at: string`

      When the enrollment was created

    - `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

      - `"pending"`

      - `"enrolled"`

      - `"waived"`

      - `"inactive"`

    - `terminated_at: string | null`

      When coverage was terminated

    - `updated_at: string`

      When the enrollment was last updated

### Example

```typescript
import VitableConnect from '@vitable-inc/vitable-connect';

const client = new VitableConnect({
  apiKey: process.env['VITABLE_CONNECT_API_KEY'], // This is the default and can be omitted
});

const enrollment = await client.enrollments.retrieve('enrl_abc123def456');

console.log(enrollment.data);
```

#### Response

```json
{
  "data": {
    "id": "enrl_abc123def456",
    "employee_id": "empl_xyz789ghi012",
    "employer_id": "empr_def456ghi789",
    "benefit": {
      "id": "bprd_medical456",
      "name": "MEC Plus",
      "product_code": "MEC_PLUS",
      "category": "Medical"
    },
    "status": "enrolled",
    "coverage_start": "2026-04-01",
    "coverage_end": "2027-03-31",
    "employee_deduction_in_cents": 5000,
    "employer_contribution_in_cents": 25000,
    "answered_at": "2026-01-20T14:30:00Z",
    "terminated_at": null,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-15T10:30:00Z"
  }
}
```

## Domain Types

### Enrollment

- `Enrollment`

  - `id: string`

    Unique enrollment identifier (enrl_*)

  - `answered_at: string | null`

    When the employee enrolled or waived

  - `benefit: Benefit`

    Nested benefit product summary

    - `id: string`

      Benefit product ID (bprd_*)

    - `category: "Medical" | "Dental" | "Vision" | "Hospital"`

      * `Medical` - Medical
      * `Dental` - Dental
      * `Vision` - Vision
      * `Hospital` - Hospital

      - `"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

      - `"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

  - `coverage_start: string`

    Coverage period start date

  - `created_at: string`

    When the enrollment was created

  - `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

    - `"pending"`

    - `"enrolled"`

    - `"waived"`

    - `"inactive"`

  - `terminated_at: string | null`

    When coverage was terminated

  - `updated_at: string`

    When the enrollment was last updated

### Enrollment Status

- `EnrollmentStatus = "pending" | "enrolled" | "waived" | "inactive"`

  * `pending` - Pending
  * `enrolled` - Enrolled
  * `waived` - Waived
  * `inactive` - Inactive

  - `"pending"`

  - `"enrolled"`

  - `"waived"`

  - `"inactive"`