> ## 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.

# MOUD Enrollments

> View and manage medication-assisted treatment enrollment records and treatment phase tracking at route /cl/mat.

This screen lists all MAT/MOUD enrollment records for the organization and is accessible at `/cl/mat`.

## Overview

The MOUD Enrollments page displays a table of all medication-assisted treatment enrollment records scoped to the current organization. Each row shows the medication name, treatment phase, status badge, start date, and end date (if applicable). Rows are clickable and navigate to the enrollment detail page at `/cl/mat/:enrollmentId`. Users with the `cl.moud.enroll` permission see a "New Enrollment" button that opens `MoudEnrollmentFormDialog`. The list is fetched via `useMoudEnrollmentList`, ordered by `started_on` descending. An empty state is shown when no records exist; an error card is shown when the query fails.

## Who it's for

Requires the `cl.moud.view` permission. The "New Enrollment" button is additionally gated on `cl.moud.enroll`.

## Before you start

* You must hold the `cl.moud.view` permission to access this page.
* To create a new enrollment you must also hold `cl.moud.enroll`.

## Steps

<Steps>
  <Step title="Navigate to MAT/MOUD Enrollments">
    Open the Clinical core and go to `/cl/mat`. The page loads all enrollment records for your organization, sorted by start date (most recent first).
  </Step>

  <Step title="Review the enrollment list">
    The table shows Medication, Phase, Status (with a color-coded badge), Started date, and Ended date. A "—" in the Ended column indicates the enrollment has no recorded end date.
  </Step>

  <Step title="Open an enrollment record">
    Click any row to navigate to the enrollment detail page at `/cl/mat/:enrollmentId`.
  </Step>

  <Step title="Create a new enrollment (if authorized)">
    If you hold `cl.moud.enroll`, click "New Enrollment" to open the enrollment form dialog. Complete the required fields and submit to create a new record.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Enrollment status values">
    The `enrollment_status` column uses four values rendered as badges: `active` (default style), `paused` (secondary), `completed` (outline), `discontinued` (destructive). Clinical interpretation of these statuses is not determinable from code — SME confirmation required.
  </Accordion>

  <Accordion title="Empty and error states">
    When no enrollments exist, an empty state with a pill icon and "No MAT/MOUD Enrollments" message is shown. If the data fetch fails, a card with "Unable to load enrollments. Please try again." is displayed.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Overview of the Clinical core.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</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/cl.tsx
  * src/cores/cl/pages/MoudEnrollmentListPage.tsx
  * src/cores/cl/hooks/useMoudEnrollments.ts
</Accordion>