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 7.0.0 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 |
With each major version of FHIR, the core data models have changed. The FHIR core specification provides a base resource differential to help implementers navigate version changes. However, there are additional considerations for the user and developer experience when transitioning from FHIR Version DSTU2 to FHIR R4. Similarly, US Core undergoes annual updates, which are documented on the Future of US Core page. Each update to a new version of US Core changes the US Core Profiles and conformance expectations. The following guidance on this page is provided to ensure a smoother upgrade path. It reflects non-normative best practices established at the time of publication.
US Core undergoes annual updates with new guidance, requirements, profiles, and changes to existing content. The Directory of published versions lists the publication history with links to each version of US Core. The Change Log documents the changes across the versions of US Core. The Argonaut Data Query guide was published separately and is not included in the directory or change log.
Work is underway to identify corrections in subsequent versions as “patches” to prior versions for ONC Certification.
The table below summarizes the different profiles and resource types between Argonaut Data Query and major releases of US Core :
DSTU2 Profile | Equivalent US Core Profile | Version Added | Version Retired | Notes |
---|---|---|---|---|
Argonaut CarePlan Profile | US Core CarePlan Profile | 3.1.1* | Type changed from CarePlan in DSTU2 to CareTeam in R4 | |
Argonaut CareTeam Profile | US Core CareTeam Profile | 3.1.1* | ||
Argonaut Condition Profile | US Core Condition Profile | 3.1.1* | 5.0.0 | In version 5.0.0 split US Core Condition Profilee into US Core Condition Encounter Diagnosis Profile and US Core Condition Problems and Health Concerns Profile |
- | US Core Condition Encounter Diagnosis Profile | 5.0.0 | see above | |
- | US Core Condition Problems and Health Concerns Profile | 5.0.0 | see above | |
Argonaut Device Profile | US Core Implantable Device Profile | 3.1.1* | ||
Argonaut DiagnosticReport Profile | US Core DiagnosticReport Profile for Laboratory Results Reporting | 3.1.1* | ||
Argonaut DocumentReference Profile | US Core DocumentReference Profile | 3.1.1* | ||
Argonaut Goal Profile | US Core Goal Profile | 3.1.1* | ||
Argonaut Immunization Profile | US Core Immunization Profile | 3.1.1* | ||
Argonaut Medication Profile | US Core Medication Profile | 3.1.1* | ||
Argonaut MedicationOrder Profile | US Core MedicationRequest Profile | 3.1.1* | ||
Argonaut MedicationStatement Profile | - | US Core MedicationStatement Profile not defined in 3.1.1* | ||
Argonaut Observation Results Profile | US Core Laboratory Result Observation Profile | 3.1.1* | In Version 6.0.0 derived from US Core Observation Clinical Test Result Profile | |
Argonaut Patient Profile | US Core Patient Profile | 3.1.1* | ||
Argonaut Procedure Profile | US Core Procedure Profile | 3.1.1* | ||
Argonaut Smoking Status Observation Profile | US Core Smoking Status Observation Profile | 3.1.1* | ||
Argonaut Vital Signs Observation Profile | US Core Vital Signs Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Blood Pressure Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core BMI Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Head Circumference Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Body Height Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Body Weight Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Body Temperature Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Heart Rate Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Respiratory Rate Profile | 4.0.0 | Previous to version 4.0.0, referenced the FHIR Vital Signs Profile | |
- | US Core Pediatric BMI for Age Observation Profile | 3.1.1* | 3.1.1* based on the FHIR Vital Signs Profile, 4.0.0+ based on the US Core Vital Signs Profile | |
- | US Core Pediatric Head Occipital Frontal Circumference Percentile Profile | 3.1.1* | 3.1.1* based on the FHIR Vital Signs Profile, 4.0.0+ based on the US Core Vital Signs Profile | |
- | US Core Pediatric Weight for Height Observation Profile | 3.1.1* | 3.1.1* based on the FHIR Vital Signs Profile, 4.0.0+ based on the US Core Vital Signs Profile | |
- | US Core Pulse Oximetry Profile | 3.1.1* | 3.1.1* based on the FHIR Vital Signs Profile, 4.0.0+ based on the US Core Vital Signs Profile | |
- | US Core DiagnosticReport Profile for Report and Note Exchange | 3.1.1* | ||
- | US Core Encounter Profile | 3.1.1* | ||
- | US Core Location Profile | 3.1.1* | ||
- | US Core Organization Profile | 3.1.1* | ||
- | US Core Practitioner Profile | 3.1.1* | ||
- | US Core PractitionerRole Profile | 3.1.1* | ||
- | US Core Provenance Profile | 3.1.1* | ||
- | US Core Observation Sexual Orientation Profile | 5.0.0 | ||
- | US Core Observation Social History Profile | 5.0.0 | 6.0.0 | Superseded by US Core Simple Observation Profile in version 6.0.0 |
- | US Core Observation Survey Profile | 5.0.0 | 6.0.0 | Superseded by US Core Observation Screening Assessment Profile in version 6.0.0 |
- | US Core Observation SDOH Assessment Profile | 5.0.0 | 6.0.0 | Superseded by US Core Observation Screening Assessment Profile in version 6.0.0 |
- | US Core Observation Clinical Test Result Profile | 5.0.0 | 6.0.0 | Superseded by US Core Observation Clinical Result Profile in version 6.0.0 |
- | US Core Observation Imaging Result Profile | 5.0.0 | 6.0.0 | Superseded by US Core Observation Clinical Result Profile in version 6.0.0 |
- | US Core QuestionnaireResponse Profile | 5.0.0 | ||
- | US Core RelatedPerson Profile | 5.0.0 | ||
- | US Core ServiceRequest Profile | 5.0.0 | ||
- | US Core Coverage Profile | 6.0.0 | ||
- | US Core Observation Occupation Profile | 6.0.0 | ||
- | US Core Observation Pregnancy Status Profile | 6.0.0 | ||
- | US Core Observation Pregnancy Intent Profile | 6.0.0 | ||
- | US Core Observation Clinical Result Profile | 6.0.0 | Replaces US Core Observation Clinical Test Result Profile and US Core Observation Imaging Result Profile | |
- | US Core Observation Screening Assessment Profile | 6.0.0 | Replaces US Core Observation Survey Profile and US Core Observation SDOH Assessment Profile | |
- | US Core MedicationDispense Profile | 6.0.0 | ||
- | US Core Simple Observation Profile | 6.0.0 | Replaces US Core Observation Social History Profile | |
- | US Core Specimen Profile | 6.0.0 | ||
- | US Core Average Blood Pressure Profile | 7.0.0 | ||
- | US Core Care Experience Preference Profile | 7.0.0 | ||
- | US Core Treatment Intervention Preference Profile | 7.0.0 | ||
Extensions | ||||
Sex of patient assigned at birth | US Core Birth Sex Extension | 3.1.1* | After version 6.0.0 this extension is no longer a USCDI requirement. | |
Argonaut ethnicity Extension | US Core Ethnicity Extension | 3.1.1* | ||
Argonaut Race Extension | US Core Race Extension | 3.1.1* | ||
- | US Core Direct email Extension | 3.1.1* | ||
- | US Core Extension Questionnaire URI | 5.0.0 | ||
- | US Core Gender Identity Extension | 5.0.0 | ||
- | US Core Tribal Affiliation Extension | 6.0.0 | ||
- | US Core Jurisdiction Extension | 6.0.0 | ||
- | US Core USCDI Requirements Extension | 6.0.0 | This extension is only used on US Core Profile StructureDefinition elements | |
- | US Core Sex Extension | 6.1.0 | ||
US Core Medication Adherence Extension | 7.0.0 | |||
* 3.1.1 or prior version of US Core |
Detailed comparisons between the FHIR artifacts in this current 7.0.0 version of US Core and each previous major release are provided in the links below:
A server may support Version DSTU2 and Argonaut Data Query or FHIR R4 and US Core ver 3.1.1+ or both. A server may make explicit which version of Argo/US Core is on their FHIR endpoint (e.g., “DSTU2” or “R4” path component or separate files based on version). However, the best practice is to inspect the endpoint metadata on each endpoint to discover the information about a server’s capabilities, including the FHIR version and the US Core Profile version that is supported:
GET [base]/metadata{?mode=[mode]} {&_format=[mime-type]}
In some FHIR servers, the identifier of the underlying clinical data is not maintained across FHIR versions. Therefore, client applications must plan on deduplication methods that rely on something other than a common identifier across FHIR versions.
In an upgraded R4 endpoint, any data in FHIR DSTU2 SHOULD be in FHIR R4. However, not all data in R4 may be available in DSTU2 because some profiles and data classes, like Clinical Notes and pediatric observations, are not part of DSTU2.