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

# Pending Approvals

> View and act on all documents awaiting your approval, filtered by urgency and document category.

All authenticated users can access their approval queue at `/documents/approvals`. This route renders `PendingApprovalsPage` from `src/platform/documents/pages/PendingApprovalsPage.tsx` with no explicit permission gate.

## Overview

The Pending Approvals page displays all documents assigned to the current user for review. It uses `usePendingApprovals()` with filters for urgency (`all`, overdue, due today, upcoming) and document category. A `usePendingApprovalCount()` hook provides the total count badge. Each document card shows urgency indicators (`isOverdue`, `isDueToday`). Approvals are sorted by `due_date` by default. Urgency and sort controls are exposed as select dropdowns.

## Who it's for

Access follows your organization's role and module configuration. Any authenticated user sees their own approval queue.

## Before you start

* You must be signed in.
* Documents must be assigned to you via an approval chain.

## Steps

1. Navigate to `/documents/approvals` or select **Approvals** from the documents navigation.
2. Use the urgency filter to prioritize overdue or due-today items.
3. Filter by document category if needed.
4. Select a document card to open the document and take approval action.

## Key concepts

**Urgency** — Documents flagged as `isOverdue` have passed their due date. Documents flagged as `isDueToday` are due on the current date.

**Sort options** — The default sort is `due_date`. Other sort options are available via the `SortOption` type in `usePendingApprovals`.

**Document categories** — Supported: `policy`, `procedure`, `form`, `report`, `contract`, `license`, `training`, `other`.

## 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/platform.tsx
  * src/platform/documents/pages/PendingApprovalsPage.tsx
  * src/platform/documents/hooks/usePendingApprovals.ts
</Accordion>
