PriorAuthTimeline
ComplexRevenue
<co-prior-auth-timeline>PriorAuthTimeline shows a prior authorization: status, units used against approved (UnitsMeter), any alert and the status history.
import { PriorAuthTimeline } from 'health-components';
Examples
Showcase
Denied
Units Meter Alone
Usage
<PriorAuthTimeline authId="PA-2026-11873" service="Physical therapy 97110" payer="Aetna" status="Approved"
used={12} approved={20} unit="visits" expires="10/01/2026 to 12/31/2026" events={history} />
<UnitsMeter used={12} approved={20} unit="visits" />
When to use
- PA detail drawer or page; referral status uses the same parts.
When not to use
- The queue list: DataTable with StatusTag.
Variants and states
| Variant | What it is |
|---|---|
| pending | No units yet, current step In Review. |
| approved | UnitsMeter turns amber at 75% and red at 90%. |
| alert | Expiry or more-info warning with an action. |
| denied | Failed step, danger tag. |
Accessibility
- Meter role with "12 of 20 visits" text.
Do and don't
- Do: Offer Request Extension when 1 to 2 units remain.
- Don't: Show units without the expiry date.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
authId | string | "Prior authorization" | Authorization number ("PA-2026-11873") |
service | string | none | Service and code ("Physical therapy 97110") |
payer | string | none | Payer name |
patient | string | none | Patient name |
status * | string | — | PA status word (see StatusTag kind 'pa'): 'Approved', 'Pended', 'Denied'...; required |
used | number | none | Units used |
approved | number | none | Units approved; shows the UnitsMeter when set |
unit | string | "units" | Unit word |
expires | string | none | Validity dates ("10/01/2026 to 12/31/2026") |
events | TimelineItem[] | [] | Status history as Timeline items |
alert | PriorAuthAlert | none | {title, body, action?, onAction?} |
alertTone | "warning" | "error" | "info" | 'warning' | 'warning' | 'error' | 'info' |
Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.
Angular, Vue and HTML
Register the elements once (Angular guide), then use <co-prior-auth-timeline>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.
Angular template
<co-prior-auth-timeline auth-id="…" service="…" [events]="events"></co-prior-auth-timeline>
| Kind | Name | Description |
|---|---|---|
| attribute | auth-id / authId | Authorization number ("PA-2026-11873"); default "Prior authorization" |
| attribute | service | Service and code ("Physical therapy 97110"); default none |
| attribute | payer | Payer name; default none |
| attribute | patient | Patient name; default none |
| attribute | status | PA status word (see StatusTag kind 'pa'): 'Approved', 'Pended', 'Denied'...; required |
| attribute | used | Units used; default none |
| attribute | approved | Units approved; shows the UnitsMeter when set; default none |
| attribute | unit | Unit word; default "units" |
| attribute | expires | Validity dates ("10/01/2026 to 12/31/2026"); default none |
| property / JSON attribute | events | Status history as Timeline items; default [] |
| property / JSON attribute | alert | {title, body, action?, onAction?}; default none |
| attribute | alert-tone / alertTone | 'warning' | 'error' | 'info'; default 'warning' |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus |