Skip to content
Get started

Reissue enrollment with QLE

enrollments.reissue(enrollment_id, **kwargs) -> Enrollment { id, benefit_product_id, created_at, 13 more }
post/v1/enrollments/{enrollment_id}/reissue

Reissues an enrollment due to a qualifying life event, allowing mid-year benefit changes. Enables employees to modify benefit selections outside open enrollment after a significant life event. Common scenarios: adding newborn child, covering new spouse, adjusting coverage after losing other coverage.

ParametersExpand Collapse
enrollment_id: String
qle_id: String

ID of the qualifying life event (qle_*)

reason: String

Optional reason for reissue

maxLength500
ReturnsExpand Collapse
class Enrollment { id, benefit_product_id, created_at, 13 more }

Serializer for Enrollment entity in public API responses.

An Enrollment represents an employee's benefit enrollment for a specific plan year.

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_*)

  • 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

Reissue enrollment with QLE
require "vitable_connect_api"

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

enrollment = vitable_connect_api.enrollments.reissue("enrl_abc123def456", qle_id: "qle_id")

puts(enrollment)
{
  "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"
}