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

# Enrollment

> View and manage a provider credentialing enrollment record with NPI, taxonomy, dates, event history, and validation tools.

The Enrollment screen (Provider Credentialing Enrollment Detail) displays a single provider enrollment record within the Credentialing module at route `/pm/credentialing/enrollments/:enrollmentId`.

## Overview

The page loads an enrollment via `useProviderEnrollmentDetail` and its event history via `useProviderEnrollmentEventsList`. The header shows the payer name (from joined `pm_payers`), a truncated provider identity ID, and an enrollment status badge (`pending`, `enrolled`, `denied`, `inactive`). Two cards are displayed: **Enrollment Details** (rendering NPI, billing NPI, taxonomy code, effective date, expiration date, re-credential due date, and denial reason if present) with an Edit button (requires `pm.credentialing.manage`); and **Validation** (text description of NPI/taxonomy validation) with a Record Validation button (requires `pm.credentialing.validate`) that opens `ProviderIdentifierValidationDialog`. Below the cards, the Event History section lists enrollment lifecycle events with icons, labels, and timestamps.

## Who it's for

Requires permission `pm.credentialing.view` (enforced via `PermissionGate` wrapping the page content). The route itself requires `PM_PERMISSIONS.ADMIN`. Edit requires `pm.credentialing.manage`. Validation requires `pm.credentialing.validate`.

## Before you start

* You need `pm.admin` permission (route-level) and `pm.credentialing.view` (page-level).
* Navigate here from the Credentialing list (`/pm/credentialing`).

## Steps

<Steps>
  <Step title="Open a credentialing enrollment">
    From the Credentialing list (`/pm/credentialing`), click an enrollment row to open its detail page.
  </Step>

  <Step title="Review enrollment details">
    The Enrollment Details card shows rendering NPI, billing NPI, taxonomy code, effective date, expiration date, re-credential due date, and any denial reason.
  </Step>

  <Step title="Edit enrollment details (pm.credentialing.manage)">
    Click **Edit** on the Enrollment Details card to open `ProviderEnrollmentFormDialog` and update enrollment fields.
  </Step>

  <Step title="Record NPI/taxonomy validation (pm.credentialing.validate)">
    Click **Record Validation** on the Validation card to open `ProviderIdentifierValidationDialog` and record validation results.
  </Step>

  <Step title="Review event history">
    The Event History section lists all lifecycle events (created, submitted, approved, denied, re-credential requested/completed, expired) with timestamps.
  </Step>
</Steps>

## Key concepts

| Term                  | Meaning in code                                                                                             |
| --------------------- | ----------------------------------------------------------------------------------------------------------- |
| `rendering_npi`       | NPI used for rendering provider on claims                                                                   |
| `billing_npi`         | NPI used for the billing entity                                                                             |
| `taxonomy_code`       | Provider taxonomy code (SME confirm validation source)                                                      |
| `enrollment_status`   | `pending`, `enrolled`, `denied`, `inactive`                                                                 |
| `recert_due_on`       | Date by which re-credentialing must be completed                                                            |
| `EnrollmentEventType` | `created`, `submitted`, `approved`, `denied`, `recredential_requested`, `recredential_completed`, `expired` |

## Related

<Columns cols={2}>
  <Card title="Practice Management" icon="briefcase" href="/pm/overview">
    Practice Management core overview.
  </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/pm.tsx
  * src/cores/pm/pages/ProviderEnrollmentDetailPage.tsx
  * src/cores/pm/hooks/useProviderEnrollmentDetail.ts
  * src/cores/pm/hooks/useProviderEnrollmentEventsList.ts
</Accordion>