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 keyMBR0000012
statusYesactive, cancelled, draft, entered-in-error fm-statusactive
member_idYes, unless subscriber_id is sentplan member idMBR0000012
subscriber_idYes, unless member_id is senttextMBR0000012
relationship_codeYesself, spouse, child, other subscriber-relationshipself
coverage_type_codeRecommendedSource of Payment Typology Payer Type1 Medicare
payer_org_identifierYesthe payer; key from organizations99999
group_numberIf availabletextGRP-4410
group_nameIf availabletextAcme Manufacturing
plan_numberIf availabletextH6776-001
plan_nameIf availabletextGold PPO
network_idIf availabletextNET-GOLD-NY
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.
  • network_id is the provider network this coverage is under, published to Coverage.network. It is a linking key, not a name: send the same identifier you use for that network in your provider directory delivery, so a member’s coverage and that network’s providers can be joined. It is stored as sent — we do not resolve it against any registry.

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

Last updated: