Select Coverage
Use the Select Coverage screen to choose an existing insurance policy and set it as the active policy for the patient.
This screen includes:
- A modal header with the title Select your coverage and a close control.
- A search input that filters insurance providers in real time.
- A scrollable list of coverage providers with logos and names.
- A vertical scroll indicator for navigating long provider lists.
- A selectable list layout for choosing a provider.
- A fallback section for users who cannot find their coverage.
- Informational text that explains the private user option and reimbursement possibility.
- A primary action button labeled Continue as private user.
Entry Points
The SDK presents the Select Coverage screen from the following flows:
Workflow
- Open the Policy field from the Home screen.
- The platform returns the list of available coverage providers for the authenticated patient.
- Display the list of coverage providers.
- Select a coverage provider.
- Submit the selection.
- The platform validates the selected policy.
- If validation succeeds, the platform sets the selected policy as active.
- The app updates coverage-dependent UI based on the active policy.
Validations
These rules define policy eligibility and selection constraints enforced by the platform.
| Condition | App behavior | SDK output |
|---|---|---|
| No policy selected. | Disable confirmation action. | No request is sent. |
| Selected policy is expired or not yet active. | Display disabled option. | Policy returned with inactive state. |
| Policy is not eligible for the current flow. | Display disabled option. | Policy flagged as ineligible in response. |
| No matching provider found. | Display fallback section. | Empty result set returned. |
| Screen opened from restricted flow. | Hide private option. | Configuration flag returned by platform. |
Actions
These actions define behavior during policy selection.
| Condition | App behavior | SDK output |
|---|---|---|
| Screen loads. | Display loading state. | Request coverage list from platform. |
| Policies returned. | Render list with state indicators (active, future, expired). | Coverage list response. |
| User selects a policy. | Mark selection in UI. | No request sent until confirmation. |
| User confirms selection. | Submit selection request. | POST request to set active policy. |
| Selection succeeds. | Update UI to reflect active policy. | Response with updated policy context. |
| User selects private option. | Switch UI to private-pay mode. | Request updates session context. |
Endpoint Resources
Select Coverage
PUT
v3/coverage
Displays coverage selection screen.
Select Policy
POST
v3/coverage/select
Changes patient's current policy to selected one.

