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

# COBRA Events

> Admin list of COBRA qualifying events with status filtering, deadline tracking, and detailed event management including notice actions and election recording.

COBRA Events is available at route `/hr/benefits/cobra`, guarded by `hr.benefits.admin`.

## Overview

The COBRA Events List page shows all COBRA qualifying events for the organization with filterable tabs by status (`all`, `pending_notice`, `notice_sent`, `elected`, `declined`, `terminated`, `expired`). Each event row shows the employee avatar and name, qualifying event label, event date, a deadline indicator (overdue, within 7 days warning, or formatted date), and a status badge. The `DeadlineIndicator` component highlights overdue or soon-due notices. An event count badge appears on each status tab. Row actions include viewing the event detail and sending a notice if applicable.

## Who it's for

`hr.benefits.admin` — HR benefits administrators only.

## Before you start

* `hr.benefits.admin` permission required.
* COBRA qualifying events must have been recorded for terminated or life-event employees.

## Steps

<Steps>
  <Step title="Open COBRA Events">Navigate to `/hr/benefits/cobra`.</Step>
  <Step title="Filter by status">Click a status tab to show only events in that lifecycle stage.</Step>
  <Step title="Check deadlines">Look for overdue or warning indicators in the deadline column.</Step>
  <Step title="Open event detail">Click a row to navigate to `/hr/benefits/cobra/:id` for full detail and actions.</Step>
</Steps>

## Key concepts

| Term                            | Meaning in code                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------- |
| `CobraEventStatus`              | `pending_notice`, `notice_sent`, `elected`, `declined`, `terminated`, `expired` |
| `COBRA_QUALIFYING_EVENT_LABELS` | Display labels mapping internal event type identifiers to human-readable names  |
| `DeadlineIndicator`             | Inline component showing days remaining or "Overdue" with color coding          |

## Viewing a COBRA event

The COBRA Event Details page is available at route `/hr/benefits/cobra/:id`, guarded by `hr.benefits.admin`. It loads a single COBRA qualifying event by `:id`. The breadcrumb reflects the qualifying event type. The page shows event details (employee name with avatar, qualifying event label, event date, coverage period deadlines), an election form section (`CobraElectionForm` toggled by a **Record Election** button), event timeline, and status management. Available actions depend on event status: `pending_notice` enables **Send Notice** which calls `sendNotice.mutateAsync`; status can also be updated via `updateStatus`. The `COBRA_COVERAGE_PERIODS` and `COBRA_QUALIFYING_EVENT_LABELS` constants from the COBRA types module provide display labels.

Before you start: `hr.benefits.admin` permission required. Navigate from `/hr/benefits/cobra`.

1. Navigate from `/hr/benefits/cobra` and click an event row.
2. Check employee, qualifying event type, event date, and deadline status.
3. If status is `pending_notice`, click **Send Notice** to send the COBRA notice.
4. Click **Record Election** to open the `CobraElectionForm` and capture the beneficiary's decision.
5. Use status update actions as the event progresses through its lifecycle.

**Key detail concepts:**

| Term                            | Meaning in code                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------- |
| `CobraEventStatus`              | `pending_notice`, `notice_sent`, `elected`, `declined`, `terminated`, `expired` |
| `COBRA_QUALIFYING_EVENT_LABELS` | Display labels for qualifying event types                                       |
| `COBRA_COVERAGE_PERIODS`        | Coverage period definitions from `../../types/cobra`                            |
| `CobraElectionForm`             | Form component for recording a beneficiary's COBRA election decision            |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources 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/hr.tsx
  * src/routes/hr/benefits-routes.tsx
  * src/cores/hr/benefits/pages/admin/CobraEventsListPage.tsx
  * src/cores/hr/benefits/pages/admin/CobraEventDetailPage.tsx
  * src/cores/hr/benefits/hooks/useCobraEvents.ts
  * src/cores/hr/benefits/types/cobra.ts
</Accordion>