US Core Implementation Guide
10.0.0-ballot - STU 10 Ballot United States of America flag

US Core Implementation Guide, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 10.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/US-Core/ and changes regularly. See the Directory of published versions

USCDI

Page standards status: Informative

The US Core Profiles were initially designed to meet the 2015 Edition certification criterion for Patient Selection 170.315(g)(7) and Application Access – Data Category Request 170.315(g)(8). US Core Editors have updated the guide annually to meet subsequent U.S. Core Data for Interoperability (USCDI) requirements:

USCDI Version US Core Version
v1 3.1.1
v1 4.0.0 (improved Must support guidance)
v2 5.0.1
v3.1 6.1.0
v4 7.0.0
v5 8.0.1
v6 9.0.0
v7 10.0.0

USCDI and US Core

The Office of the National Coordinator for Health Information Technology (ONC) USCDI and FHIR US Core are complementary initiatives, with USCDI defining high-level data requirements and FHIR US Core providing detailed FHIR-based profiles for meeting those requirements. Mapping between them is necessary for achieving interoperability and consistency in healthcare data exchange within the United States. However, to make USCDI implementable in FHIR, an interpretation of USCDI is necessary. For information about what US Core Profile elements and US Core transactions are in scope for ONC Health IT Certification, see the US Core Conformance pages.

Note that:

  • USCDI Data Classes and Element names may differ from the FHIR US Core resource names and element names.
  • Not every USCDI Data Class and Element is mapped to a single profile.
  • Many US Core Profile elements do not map to a USCDI Data Classes and Element because US Core's usage is broader than certification and because additional US Core elements are required to make FHIR implementable.

Updates to US Core depend upon community input, and we encourage our audience to submit questions and feedback to US Core specifications by clicking on the Propose a change link in the footer of every page. In addition, we encourage our audience to request any necessary clarifications to USCDI through the USCDI ONDEC process that will help inform future updates to FHIR US Core.

Anticipating Future USCDI Versions

The USCDI framework includes Data Classes and Elements which are not yet part of the core USCDI requirements but are under consideration for future inclusion. They are categorized by "Levels" to represent data elements in earlier stages of development and adoption, with Level 1 indicating potential data elements with limited use cases and Level 2 reflecting more defined use cases and broader community interest. We encourage implementers and stakeholders to review these emerging data elements and provide feedback through the USCDI ONDEC process to help shape their development and ensure alignment with future FHIR US Core updates.

USCDI to US Core Mapping Table

The table below defines the relationship between the USCDI Data Classes and Elements and USCore profiles. It lists the US Core Profile used for the corresponding Data Classes and Elements. This information and FHIRPath expressions to USCDI Data Classes and Elements are available as a csv or excel file:

USCDI Logo

US Core Data for Interoperability USCDI

USCDI Data Class/Element US Core Profile Notes
Adverse Events
Adverse Events - See Adverse Events Guidance
    •Adverse Event Condition See Adverse Events Guidance
    •Adverse Event Outcome See Adverse Events Guidance
Allergies and Intolerances
Allergies and Intolerances US Core AllergyIntolerance Profile
    •Medication Allergy Intolerance US Core AllergyIntolerance Profile
    •Drug Class Allergy Intolerance US Core AllergyIntolerance Profile
    •Non-Medication Allergy Intolerance US Core AllergyIntolerance Profile
    •Reaction US Core AllergyIntolerance Profile
    •Allergy Intolerance Criticality US Core AllergyIntolerance Profile
Care Plans
Care Plans US Core CarePlan Profile
    •Care Plan US Core CarePlan Profile
    •Assessment and Plan of Treatment US Core CarePlan Profile
Encounter Information
Encounter Information US Core Encounter Profile
US Core Condition Encounter Diagnosis Profile
US Core Appointment Profile
    •Encounter Identifier US Core Encounter Profile
    •Encounter Type US Core Encounter Profile
    •Encounter Diagnosis US Core Condition Encounter Diagnosis Profile
    •Encounter Date and Time US Core Encounter Profile
    •Encounter Location US Core Encounter Profile
    •Encounter Disposition US Core Encounter Profile
    •Appointment US Core Appointment Profile
Facility Information
Facility Information US Core Location Profile See Facility Information Guidance
    •Facility Identifier US Core Location Profile
    •Facility Type US Core Location Profile
    •Facility Name US Core Location Profile
    •Facility Address US Core Location Profile
    •Facility Telecom US Core Location Profile
Family Health History
Family Health History US Core FamilyMemberHistory Profile
    •Family Health History US Core FamilyMemberHistory Profile
Health Insurance Information
Health Insurance Information US Core Coverage Profile
US Core Organization Profile
    •Health Insurance Coverage Status US Core Coverage Profile
    •Health Insurance Coverage Type US Core Coverage Profile
    •Relationship to Health Insurance Subscriber US Core Coverage Profile
    •Health Insurance Member Identifier US Core Coverage Profile
    •Health Insurance Subscriber Identifier US Core Coverage Profile
    •Health Insurance Group Identifier US Core Coverage Profile
    •Health Insurance Payer Identifier US Core Coverage Profile
US Core Organization Profile
    •Health Insurance Coverage Period US Core Coverage Profile
    •Health Insurance Payer US Core Coverage Profile
    •Health Insurance Plan US Core Coverage Profile
    •Health Insurance Plan Identifier US Core Coverage Profile
Health Status Assessments
Health Status Assessments US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
US Core Observation Pregnancy Status Profile
US Core Observation Pregnancy Intent Profile
US Core Tobacco And Nicotine Use Observation Profile
    •Functional Status US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Disability Status US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Mental/Cognitive Status US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Pregnancy Status US Core Observation Pregnancy Status Profile
US Core Observation Pregnancy Intent Profile
    •Alcohol Use US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Substance Use US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Physical Activity US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •SDOH Assessment US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
    •Tobacco and Nicotine Product Use US Core Tobacco And Nicotine Use Observation Profile
    •Nutrition Assessment US Core Simple Observation Profile
US Core Condition Problems and Health Concerns Profile
US Core Observation Screening Assessment Profile
US Core QuestionnaireResponse Profile
See Screening and Assessments Guidance
Immunizations
Immunizations US Core Immunization Profile
    •Immunization US Core Immunization Profile
    •Immunization Lot Number US Core Immunization Profile
    •Immunization Status US Core Immunization Profile
    •Immunization Record Source US Core Immunization Profile
Medical Devices
Medical Devices US Core Device Profile
    •Unique Device Identifier US Core Device Profile
    •Device Type US Core Device Profile
Patient Demographics/Information
Patient Demographics/Information US Core Patient Profile
US Core RelatedPerson Profile
US Core Observation Occupation Profile
US Core Individual Sex Extension
US Core Race Extension
US Core Ethnicity Extension
US Core Tribal Affiliation Extension
US Core Encounter Profile
US Core Interpreter Needed Extension
US Core Patient Accommodation Profile
    •First Name US Core Patient Profile
    •Last Name US Core Patient Profile
    •Previous Name US Core Patient Profile
    •Middle Name (including middle initial) US Core Patient Profile
    •Name Suffix US Core Patient Profile
    •Sex US Core Patient Profile
US Core Individual Sex Extension
    •Date of Birth US Core Patient Profile
    •Date of Death US Core Patient Profile
    •Race US Core Patient Profile
US Core Race Extension
    •Ethnicity US Core Patient Profile
US Core Ethnicity Extension
    •Tribal Affiliation US Core Patient Profile
US Core Tribal Affiliation Extension
    •Preferred Language US Core Patient Profile
    •Interpreter Needed US Core Patient Profile
US Core Encounter Profile
US Core Interpreter Needed Extension
    •Current Address US Core Patient Profile
    •Previous Address US Core Patient Profile
    •Email Address US Core Patient Profile
    •Phone Number US Core Patient Profile
    •Phone Number Type US Core Patient Profile
    •Related Person's Name US Core RelatedPerson Profile
    •Relationship Type US Core RelatedPerson Profile
    •Occupation US Core Observation Occupation Profile
    •Occupation Industry US Core Observation Occupation Profile
    •Patient Identifier US Core Patient Profile
    •Deceased Indicator US Core Patient Profile
    •Accommodation US Core Patient Accommodation Profile
Provenance
Provenance US Core Provenance Profile See Basic Provenance Guidance
    •Author Individual Provenance
    •Author Role Individual Provenance
    •Author Time Stamp US Core Provenance Profile
    •Author Organization US Core Provenance Profile
Vital Signs
Vital Signs US Core Vital Signs Profile
    •Average Blood Pressure US Core Average Blood Pressure Profile
    •Diastolic Blood Pressure US Core Blood Pressure Profile
    •Systolic Blood Pressure US Core Blood Pressure Profile
    •Body Height US Core Body Height Profile
    •Body Weight US Core Body Weight Profile
    •Heart Rate US Core Heart Rate Profile
    •Respiratory Rate US Core Respiratory Rate Profile
    •Body Temperature US Core Body Temperature Profile
    •Pulse Oximetry US Core Pulse Oximetry Profile
    •Inhaled Oxygen Concentration US Core Pulse Oximetry Profile
    •BMI Percentile (2-20 years) US Core Pediatric BMI for Age Observation Profile
    •Weight-for-length Percentile (Birth - 24 Months) US Core Pediatric Weight for Height Observation Profile
    •Head Occipital-frontal Circumference Percentile (Birth - 36 Months) US Core Pediatric Head Occipital Frontal Circumference Percentile Profile