> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# My Appointments

> Patient portal page showing upcoming and past appointments, with the ability to cancel scheduled appointments.

My Appointments is the patient portal page at `/portal/appointments` where portal-authenticated patients view their upcoming and past appointments and cancel scheduled appointments.

## Overview

The page is nested under the `/portal` layout (`PortalLayout`) defined in `src/routes/pm.tsx`. It fetches appointments via `usePortalAppointments` and displays them in two tabs: **Upcoming** and **Past**. Each appointment card shows the date, time, type, provider/location, and status badge. A cancel action on upcoming appointments triggers `usePortalCancelAppointment` with a confirmation dialog.

This is a PM-owned route (Practice Management core), surfaced in the PF docs as a patient-facing platform feature.

## Who it's for

Access follows your organization's role and module configuration. Access is controlled by portal authentication (`/portal` layout requires portal login).

## Before you start

* Patient must be registered and logged into the patient portal.
* Appointments must be scheduled by the care team for them to appear here.

## Steps

1. Log in to the patient portal at `/portal`.
2. Navigate to **Appointments** (`/portal/appointments`).
3. Review the **Upcoming** tab for scheduled appointments.
4. Review the **Past** tab for appointment history.
5. To cancel an upcoming appointment, click **Cancel** on the appointment card.
6. Confirm the cancellation in the dialog.

## Key concepts

**Appointment status** — badges indicate: `scheduled`, `confirmed`, `completed`, `cancelled`, `no_show`. Status colors use semantic tokens (accent, success, muted, destructive, warning).

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/pm.tsx
  * src/cores/pm/pages/portal/PortalAppointmentsPage.tsx
  * src/cores/pm/hooks/usePortalAppointments.ts
</Accordion>