Waive or Cancel Coverage
Waive or Cancel Coverage
Remove a coverage as if it were never active. This is often used to correct a mistake or reflect a member’s changed decision
{
"snapshot_mode": "current_open",
"employee": {}, // omitted for brevity
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "84a6c0a6-4ae9-484b-ab8d-af1ab6551efe",
"enrolled_members": [
{
"custom_individual_id": "150D001",
"individual_type": "employee",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
},
{
"custom_individual_id": "150D0C2",
"individual_type": "dependent",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
}
]
}
],
"events": [
{
"id": "10002",
"date": "2023-03-20",
"type": "coverage",
"reason": "offline_change"
}
]
}
{
"snapshot_mode": "current_open",
"employee": {}, // omitted for brevity
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "84a6c0a6-4ae9-484b-ab8d-af1ab6551efe",
"enrolled_members": [
{
"custom_individual_id": "150D001",
"individual_type": "employee",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
},
{
"custom_individual_id": "150D0C2",
"individual_type": "dependent",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
}
]
}
],
"events": [
{
"id": "10002",
"date": "2023-03-20",
"type": "coverage",
"reason": "offline_change"
}
]
}
1
Current state
Note the current state of the member and family before waiving or canceling. All coverages are active, with max end dates of 9999-12-31.
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.
2
Set effective dates
To waive/cancel coverage, set the effective_end_date
to one day before the effective_start_date
.
Was this page helpful?
{
"snapshot_mode": "current_open",
"employee": {}, // omitted for brevity
"dependents": [], // omitted for brevity
"coverages": [
{
"carrier_id": "2d370e0e-fd73-45e0-8828-796d2cacaeef",
"line_of_coverage": "dental",
"plan_id": "84a6c0a6-4ae9-484b-ab8d-af1ab6551efe",
"enrolled_members": [
{
"custom_individual_id": "150D001",
"individual_type": "employee",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
},
{
"custom_individual_id": "150D0C2",
"individual_type": "dependent",
"event_id": "10002",
"effective_start_date": "2023-04-01",
"effective_end_date": "2023-03-31",
"latest_change_effective_date": "2023-03-20"
}
]
}
],
"events": [
{
"id": "10002",
"date": "2023-03-20",
"type": "coverage",
"reason": "offline_change"
}
]
}