Skip to main content

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​

Storybook

Denied​

Storybook

Units Meter Alone​

Storybook

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​

VariantWhat it is
pendingNo units yet, current step In Review.
approvedUnitsMeter turns amber at 75% and red at 90%.
alertExpiry or more-info warning with an action.
deniedFailed 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​

PropTypeDefaultDescription
authIdstring"Prior authorization"Authorization number ("PA-2026-11873")
servicestringnoneService and code ("Physical therapy 97110")
payerstringnonePayer name
patientstringnonePatient name
status *string—PA status word (see StatusTag kind 'pa'): 'Approved', 'Pended', 'Denied'...; required
usednumbernoneUnits used
approvednumbernoneUnits approved; shows the UnitsMeter when set
unitstring"units"Unit word
expiresstringnoneValidity dates ("10/01/2026 to 12/31/2026")
eventsTimelineItem[][]Status history as Timeline items
alertPriorAuthAlertnone{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>
KindNameDescription
attributeauth-id / authIdAuthorization number ("PA-2026-11873"); default "Prior authorization"
attributeserviceService and code ("Physical therapy 97110"); default none
attributepayerPayer name; default none
attributepatientPatient name; default none
attributestatusPA status word (see StatusTag kind 'pa'): 'Approved', 'Pended', 'Denied'...; required
attributeusedUnits used; default none
attributeapprovedUnits approved; shows the UnitsMeter when set; default none
attributeunitUnit word; default "units"
attributeexpiresValidity dates ("10/01/2026 to 12/31/2026"); default none
property / JSON attributeeventsStatus history as Timeline items; default []
property / JSON attributealert{title, body, action?, onAction?}; default none
attributealert-tone / alertTone'warning' | 'error' | 'info'; default 'warning'
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus