List employee enrollments

employees.enrollments.list(employee_id, **kwargs) -> EnrollmentListResponse { id, benefit_product_id, created_at, 13 more }

get/v1/employees/{employee_id}/enrollments

Retrieves a paginated list of benefit enrollments for an employee. Enrollments have statuses: 'pending' (in enrollment period), 'enrolled' (active coverage), or 'inactive' (terminated, expired, or unanswered). Filter by status, plan year, or coverage year.

ParametersExpand Collapse

employee_id: String

coverage_effective_start_year: Integer

Filter by coverage year

limit: Integer

Items per page (default: 20, max: 100)

minimum1

maximum100

page: Integer

Page number (default: 1)

minimum1

plan_year: Integer

Filter by plan year start (YYYY)

status: EnrollmentStatus

Filter by enrollment status

Accepts one of the following:

:pending

:enrolled

:waived

:inactive

ReturnsExpand Collapse

Array[Enrollment { id, benefit_product_id, created_at, 13 more } ]

id: String

Unique enrollment identifier with 'enrl_' prefix

benefit_product_id: String

ID of the benefit product (bprd_*)

created_at: Time

Timestamp when the enrollment was created

formatdate-time

employee_id: String

ID of the employee (empl_*)

plan_year_id: String

ID of the plan year (plyr_*)

status: EnrollmentStatus

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

Accepts one of the following:

:pending

:enrolled

:waived

:inactive

updated_at: Time

Timestamp when the enrollment was last updated

formatdate-time

coverage_end_date: Date

Date when coverage ends

formatdate

coverage_start_date: Date

Date when coverage begins

formatdate

coverage_tier: CoverageTier

Unspecified - Unspecified
EE - Ee
ES - Es
EC - Ec
EF - Ef

Accepts one of the following:

:Unspecified

:EE

:ES

:EC

:EF

decision: String

Employee's election decision: 'enrolled' (accepted) or 'waived' (declined)

employee_contribution_cents: Integer

Employee's monthly contribution in cents

employer_contribution_cents: Integer

Employer's monthly contribution in cents

enrolled_dependents: Array[{ dependent_id, first_name, last_name, relationship}]

List of dependents included in this enrollment

dependent_id: String

ID of the dependent (dpnd_*)

first_name: String

Dependent's first name

last_name: String

Dependent's last name

relationship: Relationship

Spouse - Spouse
Child - Child

Accepts one of the following:

:Spouse

:Child

selected_plan_id: String

ID of the selected plan (plan_*), if enrolled

selected_plan_name: String

Name of the selected plan

List employee enrollments

require "vitable_connect_api"

vitable_connect_api = VitableConnectAPI::Client.new(
  api_key: "My API Key",
  environment: "environment_1" # defaults to "production"
)

enrollments = vitable_connect_api.employees.enrollments.list("empl_abc123def456")

puts(enrollments)

[
  {
    "id": "id",
    "benefit_product_id": "benefit_product_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "employee_id": "employee_id",
    "plan_year_id": "plan_year_id",
    "status": "pending",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "coverage_end_date": "2019-12-27",
    "coverage_start_date": "2019-12-27",
    "coverage_tier": "Unspecified",
    "decision": "decision",
    "employee_contribution_cents": 0,
    "employer_contribution_cents": 0,
    "enrolled_dependents": [
      {
        "dependent_id": "dependent_id",
        "first_name": "first_name",
        "last_name": "last_name",
        "relationship": "Spouse"
      }
    ],
    "selected_plan_id": "selected_plan_id",
    "selected_plan_name": "selected_plan_name"
  }
]

Returns Examples

[
  {
    "id": "id",
    "benefit_product_id": "benefit_product_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "employee_id": "employee_id",
    "plan_year_id": "plan_year_id",
    "status": "pending",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "coverage_end_date": "2019-12-27",
    "coverage_start_date": "2019-12-27",
    "coverage_tier": "Unspecified",
    "decision": "decision",
    "employee_contribution_cents": 0,
    "employer_contribution_cents": 0,
    "enrolled_dependents": [
      {
        "dependent_id": "dependent_id",
        "first_name": "first_name",
        "last_name": "last_name",
        "relationship": "Spouse"
      }
    ],
    "selected_plan_id": "selected_plan_id",
    "selected_plan_name": "selected_plan_name"
  }
]