Remove Coverage
Use the Remove Coverage action on the My Coverage screen to unlink an insurance policy from a patient account.
This screen includes:
- A header with:
- Back button.
- Screen title:
My Coverage. - Settings button.
- One or more policy cards that display:
- Insurer logo.
Policy number(if available).Periodwith start and end dates.Policyholders(if provided).- Policy status label:
Active Policy.Policy was removed.
- A
Remove Policybutton on active policy cards. - An
Add coveragebutton at the bottom of the screen.
Workflow
- Open Account > My Coverage.
- Select the Remove policy for the policy card.
- Select OK to remove the policy.
- Select Cancel to keep the policy and close the dialog.
After successful removal, the policy card displays the status label Policy was removed.
Validations
| Scenario | App Behavior |
|---|---|
| Policy status is active. | The Remove Policy button is available. |
| Policy status is removed. | The remove action is not available. |
User selects Cancel in the confirmation dialog. | The dialog closes and the policy remains active. |
| Remove request fails. | An error message appears and the policy remains active. |
Actions
| Scenario | App Behavior |
|---|---|
| Screen opens. | The app loads all linked policies and their status. |
User selects Remove Policy. | The confirmation dialog displays. |
| User confirms removal. | The app unlinks the policy and updates the status label. |
| Policy removal completes. | The card displays Policy was removed. |
User selects Add coverage. | The add-coverage flow opens. |
Endpoint Resources
Remove Policy Confirmation
PUT
/policies/delete
This endpoint returns the confirmation popup configuration for removing a policy.
Remove Policy
POST
/policies/delete
This endpoint removes an insurance policy from the user’s coverage by canceling it.

