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
| 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 |
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:
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.
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.
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:
US Core Data for Interoperability USCDI
| USCDI Data Class/Element | US Core Profile | Notes |
|---|
| Adverse Events | - | See Adverse Events Guidance |
|---|---|---|
| •Adverse Event Condition | See Adverse Events Guidance | |
| •Adverse Event Outcome | See Adverse Events Guidance |
| 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 | US Core CarePlan Profile | |
|---|---|---|
| •Care Plan | US Core CarePlan Profile | |
| •Assessment and Plan of Treatment | US Core CarePlan Profile |
| Care Team Members |
US Core CareTeam Profile
US Core Practitioner Profile US Core Patient Profile US Core RelatedPerson Profile US Core PractitionerRole Profile |
|
|---|---|---|
| •Care Team Member Name |
US Core Practitioner Profile
US Core Patient Profile US Core RelatedPerson Profile |
|
| •Care Team Member Identifier |
US Core Practitioner Profile
US Core Patient Profile |
|
| •Care Team Member Location |
US Core PractitionerRole Profile
US Core Practitioner Profile US Core Patient Profile US Core RelatedPerson Profile |
|
| •Care Team Member Telecom |
US Core PractitionerRole Profile
US Core Practitioner Profile US Core Patient Profile US Core RelatedPerson Profile |
|
| •Care Team Member Role | US Core CareTeam Profile | |
| •Healthcare Agent |
US Core CareTeam Profile
US Core RelatedPerson Profile |
| Clinical Notes |
US Core DocumentReference Profile
US Core DiagnosticReport Profile for Report and Note Exchange |
See Clinical Notes Guidance |
|---|---|---|
| •Consultation Note | US Core DocumentReference Profile | |
| •Discharge Summary Note | US Core DocumentReference Profile | |
| •History & Physical | US Core DocumentReference Profile | |
| •Procedure Note |
US Core DocumentReference Profile
US Core DiagnosticReport Profile for Report and Note Exchange |
|
| •Progress Note | US Core DocumentReference Profile | |
| •Operative Note | US Core DocumentReference Profile | |
| •Emergency Department Note | US Core DocumentReference Profile | |
| •Referral Note | US Core DocumentReference Profile |
| 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 | 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 | US Core FamilyMemberHistory Profile | |
|---|---|---|
| •Family Health History | US Core FamilyMemberHistory Profile |
| Goals and Preferences |
US Core Goal Profile
US Core Observation ADI Documentation Profile US Core ADI DocumentReference Profile US Core Treatment Intervention Preference Profile US Core Care Experience Preference Profile |
|
|---|---|---|
| •Patient Goal | US Core Goal Profile | See Screening and Assessments Guidance |
| •Advance Directive Observation |
US Core Observation ADI Documentation Profile
US Core ADI DocumentReference Profile |
|
| •Treatment Intervention Preference | US Core Treatment Intervention Preference Profile | |
| •Care Experience Preference | US Core Care Experience Preference Profile |
| 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 |
| Healthcare Information Attributes |
US Core DiagnosticReport Profile for Laboratory Results Reporting
US Core DiagnosticReport Profile for Report and Note Exchange US Core MedicationRequest Profile US Core Procedure Profile US Core Immunization Profile |
|
|---|---|---|
| •Diagnostic Report Date and Time |
US Core DiagnosticReport Profile for Laboratory Results Reporting
US Core DiagnosticReport Profile for Report and Note Exchange |
|
| •Indication | US Core MedicationRequest Profile | |
| •Performance Date and Time |
US Core Procedure Profile
US Core DiagnosticReport Profile for Report and Note Exchange US Core Immunization Profile |
|
| •Reason Not Performed |
US Core Immunization Profile
US Core Procedure Profile |
| 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 | US Core Device Profile | |
|---|---|---|
| •Unique Device Identifier | US Core Device Profile | |
| •Device Type | US Core Device Profile |
| Medications |
US Core MedicationRequest Profile
US Core MedicationDispense Profile US Core Medication Profile US Core Medication Adherence Extension US Core MedicationAdministration Profile |
See Medication List Guidance |
|---|---|---|
| •Medication |
US Core Medication Profile
US Core MedicationRequest Profile |
|
| •Dose | US Core MedicationRequest Profile | |
| •Dose Unit of Measure | US Core MedicationRequest Profile | |
| •Route of Administration |
US Core MedicationRequest Profile
US Core MedicationDispense Profile |
|
| •Medication Instructions | US Core MedicationRequest Profile | |
| •Medication Adherence |
US Core MedicationRequest Profile
US Core Medication Adherence Extension |
|
| •Medication Administration | US Core MedicationAdministration Profile | |
| •Medication Dispense Status | US Core MedicationDispense Profile | |
| •Medication Dispense Quantity |
US Core MedicationRequest Profile
US Core MedicationDispense Profile |
| Orders |
US Core MedicationRequest Profile
US Core ServiceRequest Profile US Core ADI DocumentReference Profile US Core DeviceRequest Profile US Core NutritionOrder Profile |
|
|---|---|---|
| •Medication Order | US Core MedicationRequest Profile | |
| •Laboratory Order | US Core ServiceRequest Profile | |
| •Diagnostic Imaging Order | US Core ServiceRequest Profile | |
| •Clinical Test Order | US Core ServiceRequest Profile | |
| •Procedure Order | US Core ServiceRequest Profile | |
| •Portable Medical Order | US Core ADI DocumentReference Profile | |
| •Referral Order | US Core ServiceRequest Profile | |
| •Medical Device Order | US Core DeviceRequest Profile | |
| •Nutrition Order | US Core NutritionOrder Profile |
| Procedures |
US Core Procedure Profile
US Core ServiceRequest Profile |
|
|---|---|---|
| •Procedure |
US Core Procedure Profile
US Core ServiceRequest Profile |
See Screening and Assessments Guidance |
| •Reason for Referral |
US Core ServiceRequest Profile
US Core Procedure Profile |
|
| •Procedure Status | US Core Procedure Profile |
| 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 | 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 |