Doctor List

---

The Doctor List screen displays doctors based on location, policy coverage, and active filters.

This screen includes

• Location search input.
• Visit type selectors (Clinic/Home, Video) based on policy coverage.
• Map, Filters, and Sort controls.
• Optional First Available Doctor card.
• Doctor cards displaying:
  • Name, specialty, subspecialty.
  • Rating with capped review count (99+).
  • Visit type icons.
  • Languages with +X more overflow indicator.
  • Distance or full clinic address.
  • Pricing (when applicable).
  • Availability buttons (when applicable).
  • Appointment status (when applicable).

---

Workflow

The Doctor List screen follows this execution sequence:

1. Sign in to the Air Doctor app.
2. From the Home Screen, select a specialty.
3. The app displays eligible doctors for the selected specialty, sorted by distance.

important

The Doctor List evaluates coverage scope, partner eligibility, and location context before retrieving results.

---

Doctor Card

Cards render based on appointment state and layout context.

Card Types

Screenshot	Type	Render Condition	Actions
	Coverage Available	Covered doctor, no existing appointment.	Select availability.
	Full Info	Standard search result.	Select availability or open details.
	Appointment Scheduled	Existing appointment present.	Request another appointment.
	Needs Confirmation	Proposed time requires confirmation.	Request another appointment.
	Compact	Space-constrained layout (e.g., map).	Select availability (if shown).

note

The First Available Doctor card does not include navigation to the doctor details screen.

Prescription Indicator

Prescription messaging resolves in the following order:

1. State/Province (if available)
2. Country (fallback)

Possible outputs:

• Cannot prescribe in <State/Province>
• Cannot prescribe in <Country>
• Can prescribe in <State/Province>

Prescription status does not render when only in-person visits are available.

For full behavior, see Prescriptions.

Filters

• Portrait: full screen.
• Landscape: modal popup.
• Reset and View remain fixed.

See Filter for full definition.

Sort

Filter vs Sort

Filters change the result set.
Sort changes ordering of the current result set.

Available options:

• Distance (ascending)
• Years of experience (descending)

Map View

• Renders markers for the current result set.
• Applies active filters and sort.
• Displays visit type icons only.
• Hides prescription indicator.
• Selecting a marker focuses the corresponding card.
• Selecting the arrow opens doctor details.

---

Validations

State Condition	System Constraint	Output Behavior
Policy defines partner scope	Exclude doctors outside allowed partners	Filtered result set
Location resolved	Limit results to maximum 50	Truncated result set
Review count > 99	Normalize review display value	(99+)
No matching doctors	Result set size = 0	Empty state
No active filters	No additional constraints applied	Full eligible set

Actions

Input	Current State	State Transition	Output
Location update	Any	Recompute proximity scope	Replace result set
Visit type toggle	Location resolved	Apply visit type constraint	Replace result set
Apply filters	Location resolved	Apply filter constraints	Replace result set
Reset filters	Filtered state	Remove filter constraints	Replace result set
Apply sort	Any non-empty result set	Reorder existing set	Reordered result set
Switch to map	List view active	Change view mode	Map view render
Select marker	Map view active	Focus corresponding doctor	Highlighted card
Open doctor details	Doctor selected	Change screen state	Doctor Details screen
Select availability	Doctor selected	Initiate appointment flow	Appointment workflow