For AI agents: the documentation index is at /docs/payerbox/llms.txt. A Markdown version of this page is available at /docs/payerbox/data-integration/uscdi/health-insurance.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Health Insurance Information

Datasets

US Core 6.1.0 maps each USCDI data element onto a FHIR element.

DatasetUS Core 6.1.0 target profile(s)
coverageUS Core Coverage

coverage

One row per coverage. A member with more than one plan, or a plan year that changed mid-year, produces more than one row.

ColumnRequiredFormat / valuesExample
record_idYesyour stable key for this coverageCOV-0001
patient_identifierYespatient keyMRN-4471903
statusYesactive, cancelled, draft, entered-in-error fm-statusactive
member_idYes, unless subscriber_id is sentplan member idHSX9930012
subscriber_idYes, unless member_id is senttextHSX9930012
relationship_codeYesself, spouse, child, other subscriber-relationshipself
coverage_type_codeRecommendedSource of Payment Typology Payer Type1 Medicare
payer_org_npiYes10 digits, Luhn-valid over the 80840 prefix, or your payer id9999999979
group_numberIf availabletextGRP-4410
group_nameIf availabletextAcme Manufacturing
plan_numberIf availabletextH6776-001
plan_nameIf availabletextGold PPO
period_startRecommendeddate2026-01-01
period_endRecommendeddate2026-12-31
is_deletedIf retractingtrue retracts this rowtrue
  • Send at least one of member_id and subscriber_id. US Core requires a member id or a subscriber id on every Coverage, so a row with neither cannot become one.
  • A group or plan name travels with its number: send group_number with group_name, and plan_number with plan_name.

These resources are served by Patient Access, Provider Access, Payer-to-Payer, and Prior Auth.

Last updated: