General
Snapshots
Terminate an Employee
Terminate an employee’s employment and their coverages, along with any dependent coverages
{
"snapshot_mode": "current_open",
"employee": {
"id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"custom_individual_id": "1",
"classifications": {
"BranchName": "HQ",
"Department": "Sales"
},
"employment": {
"employment_status": "terminated",
"occupation": "Senior Analyst",
"hours_worked": 50,
"salary": {
"amount": 155000,
"unit": "annual",
"type": "salary",
"effective_date": "2022-08-27"
},
"employment_dates": {
"hire_date": "2021-12-20",
"full_time_start": "2022-01-01",
"terminated": "2022-10-24"
}
},
"person": {} // omitted for brevity
},
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "61b6d125-8bbf-483a-9920-f23d9442403d",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
},
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "vision",
"plan_id": "278942d6-0ee5-4275-a327-3f91dc25b451",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
}
],
"events": [
{
"id": "8",
"type": "coverage",
"reason": "termination",
"date": "2022-10-24"
}
]
}
{
"snapshot_mode": "current_open",
"employee": {
"id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"custom_individual_id": "1",
"classifications": {
"BranchName": "HQ",
"Department": "Sales"
},
"employment": {
"employment_status": "terminated",
"occupation": "Senior Analyst",
"hours_worked": 50,
"salary": {
"amount": 155000,
"unit": "annual",
"type": "salary",
"effective_date": "2022-08-27"
},
"employment_dates": {
"hire_date": "2021-12-20",
"full_time_start": "2022-01-01",
"terminated": "2022-10-24"
}
},
"person": {} // omitted for brevity
},
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "61b6d125-8bbf-483a-9920-f23d9442403d",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
},
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "vision",
"plan_id": "278942d6-0ee5-4275-a327-3f91dc25b451",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
}
],
"events": [
{
"id": "8",
"type": "coverage",
"reason": "termination",
"date": "2022-10-24"
}
]
}
Current state
The current state of the family, before the new termination request is sent. Note that all coverages are active, with end dates of 9999-12-31
. No employment termination date is present.
The current state of a family can be retrieved in the form of a member snapshot via the GET Member Snapshot by Employee ID endpoint.
Update employment status
Update employment status to terminated
Set term date
Set an employment termination date
Set coverage end dates
Set coverage end dates. Often, end dates are determined by logic agreed to in the contract between the group and the carrier
Set termination event
Set the event reason to termination
{
"id": "8",
"type": "coverage",
"reason": "termination",
"date": "2022-10-24"
}
Was this page helpful?
{
"snapshot_mode": "current_open",
"employee": {
"id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"custom_individual_id": "1",
"classifications": {
"BranchName": "HQ",
"Department": "Sales"
},
"employment": {
"employment_status": "terminated",
"occupation": "Senior Analyst",
"hours_worked": 50,
"salary": {
"amount": 155000,
"unit": "annual",
"type": "salary",
"effective_date": "2022-08-27"
},
"employment_dates": {
"hire_date": "2021-12-20",
"full_time_start": "2022-01-01",
"terminated": "2022-10-24"
}
},
"person": {} // omitted for brevity
},
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "61b6d125-8bbf-483a-9920-f23d9442403d",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
},
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "vision",
"plan_id": "278942d6-0ee5-4275-a327-3f91dc25b451",
"enrolled_members": [
{
"individual_type": "employee",
"individual_id": "52b8ff36-388a-4faf-bc42-df446f13b89a",
"effective_start_date": "2022-01-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
},
{
"individual_type": "dependent",
"individual_id": "110fef60-6e89-4341-892a-f6ff3f68c072",
"effective_start_date": "2022-07-01",
"effective_end_date": "2022-10-31",
"latest_change_effective_date": "2022-10-24",
"event_id": "8"
}
],
"signature_date": "2021-12-23"
}
],
"events": [
{
"id": "8",
"type": "coverage",
"reason": "termination",
"date": "2022-10-24"
}
]
}