Appointment List

---

Use the Appointment List screen to display appointments for the authenticated patient.

Each appointment renders as a card with provider details, visit information, status, and available actions.
Appointment state and action availability derive from backend data.

This screen includes:

• A section titled Upcoming Appointments with a calendar icon.
• A See all link that opens the full appointment list.
• Appointment cards with: * Doctor image.
• Doctor name.
• Appointment date and time.
• Visit type label such as Video.

---

Workflow

1. Open the Home screen.
2. Select Appointments.
   • Current - Displays scheduled and upcoming appointments, including confirmed visits and active requests.
     tip

     Select Refresh to request the latest appointments from the server and update the list.

   • History - Displays completed, canceled, and past appointments. See Appointment History
3. Review appointment cards.
4. Select a card to open the Appointment Details screen.

---

Validations

Render data strictly as returned.

Condition	Rendering Rule
Doctor name missing	Reserve space. Render no value.
Specialty present	Render specialty.
Specialty absent	Omit specialty.
Patient name present	Prefix with Patient:.
Confirmed time present	Render confirmed time.
Time window without confirmed time	Render time window.
No time value	Omit time group.
Early on-demand visit	Render Within 1 hour label.
Tentative time	Omit Change indicator.
Visit type = Video or Home	Render visit-type label.
Visit type = Clinic	Render clinic name and address.
Video visit fee present	Render fee.
On-demand video visit	Render on-demand note.
Status color configured	Render status badge with configured color.

Do not infer or construct missing values.

Actions

User Actions

Trigger	Result
Refresh selected	Reload appointment list.
Scroll reaches end	Append next result set if available.
Appointment card selected	Navigate to Appointment Details.
Actions available in response	Enable returned actions only.

---

Endpoint resources

Appointment List

PUT 

/patient/appointments

This endpoint returns the appointment list screen configuration for the current patient.

Load More Previous Appointments

PATCH 

/patient/appointments/load-more

Use this endpoint to load additional previous appointments through pagination. The response returns an update set that appends appointments to the currently open page.

Update Appointment List

PATCH 

/patient/appointments/update

Use this endpoint to update appointment cards that already appear in the appointment list. The response returns an update set that refreshes the referenced cards on the currently open page.