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 9.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

US Core ImplementationGuide Resource

Page standards status: Informative

Official URL: http://hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core	Version: 9.0.0
NPM package name: hl7.fhir.us.core	ComputableName: USCore
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

The US Core Implementation Guide defines the minimum set of FHIR RESTful interactions for each of the US Core Profiles to access patient data. The Data Access Framework and the Argonaut DSTU2 guides initially formed the basis for US Core. The Profiles are updated annually to support the latest requirements from ASTP U.S. Core Data for Interoperability (USCDI). For a summary of significant changes and a detailed list of the changes between versions, see the Change Notes at https://hl7.org/fhir/us/core/changes.html

• XML
• JSON

Cross Version Analysis

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.us.core.r4) and R4B (hl7.fhir.us.core.r4b) are available.

IG Dependencies

This IG Contains the following dependencies on other IGs.

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.uv.extensions.r4#1.0.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sun, Mar 26, 2023 08:46+1100+11:00)

Package hl7.fhir.uv.sdc#3.0.0 The SDC specification provides an infrastructure to standardize the capture and expanded use of patient-level data collected within an EHR. This includes two components: * Support more sophisticated questionnaire/form use-cases such as those needed for research, oncology, pathology and other clinical domains. *Support pre-population and auto-population of EHR data into forms/questionnaires for uses outside direct clinical care (patient safety, adverse event reporting, public health reporting, etc.). (built Tue, Mar 8, 2022 18:32+0000+00:00)

Package hl7.fhir.uv.xver-r5.r4#0.0.1-snapshot-2 The cross-version extensions available in FHIR R4 from FHIR R5 (built Sat, Sep 13, 2025 16:55-0400-04:00)

Package hl7.fhir.uv.tools.r4#0.9.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Dec 16, 2025 23:18+1100+11:00)

Global Profiles

There are no Global profiles defined

Copyrights

This publication includes IP covered under the following statements.

• "Material on this site is the copyrighted property of the United States Postal Service® (Postal Service™). All rights reserved. The information and images presented here may not under any circumstances be reproduced or used without prior written permission. Users may view and download material from this site only for the following purposes: (a) for personal, non-commercial home use; (b) where the materials clearly state that these materials may be copied and reproduced according to the terms stated in those particular pages; or (c) with the express written permission of the Postal Service. In all other cases, you will need written permission from the Postal Service to reproduce, republish, upload, post, transmit, distribute or publicly display material from this Web site. Users agree not to use the site for sale, trade or other commercial purposes. Users may not use language that is threatening, abusive, vulgar, discourteous or criminal. Users also may not post or transmit information or materials that would violate rights of any third party or which contains a virus or other harmful component. The Postal Service reserves the right to remove or edit any messages or material submitted by users."For more information, see https://about.usps.com/who/legal/terms-of-use.htm .
  Show Usage
  • USPS State Codes: Practitioner/practitioner-1, USCoreJurisdictionExtension... Show 4 more, USCoreLocationProfile, USCoreOrganizationProfile, USCorePatientProfile and USCorePractitionerProfile
• © Copyright 2022 American Medical Association
  Show Usage
  • NUCC Provider Taxonomy: Bundle/66c8856b-ba11-4876-8aa8-467aad8c11a2 and USCorePractitionerRoleProfile
• IEEE maintains copyright on all content from IEEE 11073 standards. All rights reserved. Implementers should obtain official copies of all applicable standards documents directly from IEEE. The inclusion of IEEE 11073 terminology codes and definitions in HL7 messages and related implementation guides is permitted under existing agreements. For permission regarding any other usage, please contact IEEE at copyrights@ieee.org.
  Show Usage
  • ISO/IEEE 11073 Medical Device Communication Nomenclature: Observation/satO2-fiO2
• ISO maintains the copyright on the country codes, and controls its use carefully. For further details see the ISO 3166 web page: https://www.iso.org/iso-3166-country-codes.html
  Show Usage
  • ISO 3166-1 Codes for the representation of names of countries and their subdivisions — Part 1: Country code: AUDIT_C, ExerciseVitalSign... Show 215 more, HungerVitalSignExample, NarrativeStatus, PHQ9Example, PRAPAREExample, TAPS, USCDIRequirement, USCore, USCoreADIDocumentReferenceProfile, USCoreAllergyIntolerance, USCoreAllergyintoleranceClinicalStatus, USCoreAllergyintolerancePatient, USCoreAuthenticationTimeExtension, USCoreAverageBloodPressureProfile, USCoreBMIProfile, USCoreBirthSexExtension, USCoreBloodPressureProfile, USCoreBodyHeightProfile, USCoreBodyTemperatureProfile, USCoreBodyWeightProfile, USCoreCareExperiencePreferenceProfile, USCoreCarePlanCategoryExtensionCodes, USCoreCarePlanProfile, USCoreCareTeam, USCoreCareTeamRole, USCoreCareplanCategory, USCoreCareplanDate, USCoreCareplanPatient, USCoreCareplanStatus, USCoreCareteamPatient, USCoreCareteamStatus, USCoreCategory, USCoreCertifyingSystemRequirements, USCoreClientRequirements, USCoreClinicalNoteType, USCoreClinicalResultObservationCategory, USCoreConditionAbatementDate, USCoreConditionAssertedDate, USCoreConditionCategory, USCoreConditionCategoryExtensionCodes, USCoreConditionClinicalStatus, USCoreConditionCode, USCoreConditionCodes, USCoreConditionCodesCurrent, USCoreConditionEncounter, USCoreConditionEncounterDiagnosisProfile, USCoreConditionLastUpdated, USCoreConditionOnsetDate, USCoreConditionPatient, USCoreConditionProblemsHealthConcernsProfile, USCoreConditionRecordedDate, USCoreCoveragePatient, USCoreCoverageProfile, USCoreDevicePatient, USCoreDeviceProfile, USCoreDeviceStatus, USCoreDeviceType, USCoreDiagnosticReportCategory, USCoreDiagnosticReportProfileLaboratoryReporting, USCoreDiagnosticReportProfileNoteExchange, USCoreDiagnosticreportCategory, USCoreDiagnosticreportCode, USCoreDiagnosticreportDate, USCoreDiagnosticreportLastUpdated, USCoreDiagnosticreportPatient, USCoreDiagnosticreportStatus, USCoreDirectEmailExtension, USCoreDocumentReferenceCategory, USCoreDocumentReferenceProfile, USCoreDocumentReferenceType, USCoreDocumentReferencesCategoryCodes, USCoreDocumentreferenceCategory, USCoreDocumentreferenceDate, USCoreDocumentreferenceId, USCoreDocumentreferencePatient, USCoreDocumentreferencePeriod, USCoreDocumentreferenceStatus, USCoreDocumentreferenceType, USCoreEncounterClass, USCoreEncounterDate, USCoreEncounterDischargeDisposition, USCoreEncounterId, USCoreEncounterIdentifier, USCoreEncounterLastUpdated, USCoreEncounterLocation, USCoreEncounterPatient, USCoreEncounterProfile, USCoreEncounterStatus, USCoreEncounterType, USCoreEthnicity, USCoreEthnicityExtension, USCoreExtensionQuestionnaireUri, USCoreFamilyMemberHistoryProfile, USCoreFamilyMemberHistoryRecorderExtension, USCoreFamilymemberhistoryCode, USCoreFamilymemberhistoryPatient, USCoreFetchDocumentReference, USCoreGenderIdentityExtension, USCoreGoalCodes, USCoreGoalDescription, USCoreGoalLifecycleStatus, USCoreGoalPatient, USCoreGoalProfile, USCoreGoalTargetDate, USCoreHeadCircumferenceProfile, USCoreHeartRateProfile, USCoreImmunizationDate, USCoreImmunizationPatient, USCoreImmunizationProfile, USCoreImmunizationStatus, USCoreIndividualSexExtension, USCoreInterpreterNeededExtension, USCoreJurisdictionExtension, USCoreLaboratoryResultObservationProfile, USCoreLaboratoryTestCodes, USCoreLocationAddress, USCoreLocationAddressCity, USCoreLocationAddressPostalcode, USCoreLocationAddressState, USCoreLocationName, USCoreLocationProfile, USCoreMedicationAdherenceExtension, USCoreMedicationDispenseProfile, USCoreMedicationProfile, USCoreMedicationRequestProfile, USCoreMedicationdispensePatient, USCoreMedicationdispenseStatus, USCoreMedicationdispenseType, USCoreMedicationrequestAuthoredon, USCoreMedicationrequestEncounter, USCoreMedicationrequestIntent, USCoreMedicationrequestPatient, USCoreMedicationrequestStatus, USCoreNonLaboratoryCodes, USCoreObservationADIDocumentationProfile, USCoreObservationCategory, USCoreObservationClinicalResultProfile, USCoreObservationCode, USCoreObservationDate, USCoreObservationLastUpdated, USCoreObservationOccupationProfile, USCoreObservationPatient, USCoreObservationPregnancyIntentProfile, USCoreObservationPregnancyStatusProfile, USCoreObservationScreeningAssessmentProfile, USCoreObservationSexualOrientationProfile, USCoreObservationSmokingStatusStatus, USCoreObservationStatus, USCoreOrganizationAddress, USCoreOrganizationName, USCoreOrganizationProfile, USCorePatientBirthdate, USCorePatientDeathDate, USCorePatientFamily, USCorePatientGiven, USCorePatientId, USCorePatientIdentifier, USCorePatientName, USCorePatientProfile, USCorePediatricBMIforAgeObservationProfile, USCorePediatricHeadOccipitalFrontalCircumferencePercentileProfile, USCorePediatricWeightForHeightObservationProfile, USCorePractitionerId, USCorePractitionerIdentifier, USCorePractitionerName, USCorePractitionerProfile, USCorePractitionerRoleProfile, USCorePractitionerrolePractitioner, USCorePractitionerroleSpecialty, USCoreProblemOrHealthConcern, USCoreProcedureCode, USCoreProcedureCodes, USCoreProcedureDate, USCoreProcedurePatient, USCoreProcedureProfile, USCoreProcedureStatus, USCoreProvenance, USCorePulseOximetryProfile, USCoreQuestionnaireResponseProfile, USCoreQuestionnaireresponseAuthored, USCoreQuestionnaireresponseId, USCoreQuestionnaireresponsePatient, USCoreQuestionnaireresponseQuestionnaire, USCoreQuestionnaireresponseStatus, USCoreRace, USCoreRaceExtension, USCoreRelatedPersonProfile, USCoreRelatedpersonId, USCoreRelatedpersonName, USCoreRelatedpersonPatient, USCoreRespiratoryRateProfile, USCoreScreeningAssessmentConditionCategory, USCoreScreeningAssessmentObservationCategory, USCoreScreeningAssessmentObservationMaximumCategory, USCoreServerRequirements, USCoreServiceRequestCategoryCodes, USCoreServiceRequestProfile, USCoreServicerequestAuthored, USCoreServicerequestCategory, USCoreServicerequestCode, USCoreServicerequestId, USCoreServicerequestPatient, USCoreServicerequestStatus, USCoreSexExtension, USCoreSimpleObservationCategory, USCoreSimpleObservationProfile, USCoreSmokingStatusProfile, USCoreSpecimenCondition, USCoreSpecimenId, USCoreSpecimenPatient, USCoreSpecimenProfile, USCoreTreatmentInterventionPreferenceProfile, USCoreTribalAffiliationExtension, USCoreVitalSignsProfile, UsCoreClientCapabilityStatement and UsCoreServerCapabilityStatement
• Licensing information can be found here These codes are listed within the UB-04 Data Specifications Manual. The Official UB-04 Data Specifications Manual, copyrighted by the American Hospital Association, is the only official source of UB-04 billing information adopted by the National Uniform Billing Committee. No other publication—governmental or private/commercial—can be considered authoritative. The AHA wants to make you aware that the use of codes, descriptions, or any other content contained in the manual to be used in a software application, publication, or any other derivative work must be properly licensed by the AHA. If your organization uses or intends to use any of the codes or other related content from the manual in this manner, please contact the AHA’s licensing manager, Tim Carlson, at 312.893.6816 or tcarlson@aha.org
  Show Usage
  • AHA NUBC Patient Discharge Status Codes: Encounter/1036 and USCoreEncounterProfile
• Most of the information on the CDC and ATSDR websites is not subject to copyright, is in the public domain, and may be freely used or reproduced without obtaining copyright permission. For information and exceptions regarding use of CDC material please see https://www.cdc.gov/other/agencymaterials.html
  Show Usage
  • Vaccine Administered Code Set (CVX): Immunization/imm-1 and USCoreImmunizationProfile
• Most of the information on the CDC and ATSDR websites is not subject to copyright, is in the public domain, and may be freely used or reproduced without obtaining copyright permission.For information and exceptions regarding use of CDC material please see https://www.cdc.gov/other/agencymaterials.html.
  Show Usage
  • CDC Race and Ethnicity: Patient/child-example, Patient/deceased-example, Patient/example and Patient/infant-example
• Some content from IHE® Copyright © 2015 IHE International, Inc .
  Show Usage
  • IHE Format Code set for use with Document Sharing: Bundle/66c8856b-ba11-4876-8aa8-467aad8c11a2, DocumentReference/episode-summary, Saint Luke's Hospital of Kansas City, USCoreADIDocumentReferenceProfile and USCoreDocumentReferenceProfile
• The UCUM codes, UCUM table (regardless of format), and UCUM Specification are copyright 1999-2009, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved. https://ucum.org/trac/wiki/TermsOfUse
  Show Usage
  • Unified Code for Units of Measure (UCUM): AUDIT_C, ExerciseVitalSign... Show 61 more, MedicationDispense/medicationdispense-example, MedicationRequest/medicationrequest-coded-oral-axid, MedicationRequest/medicationrequest-contained-oral-axid, MedicationRequest/medicationrequest-referenced-oral-axid, Observation/10-minute-apgar-score, Observation/AUDIT-C-item-example-68517-2, Observation/AUDIT-C-item-example-75626-2, Observation/average-blood-pressure, Observation/blood-pressure, Observation/bmi, Observation/bp-data-absent, Observation/capillary-refill-time-nail-bed, Observation/cbc-erythrocytes, Observation/cbc-hematocrit, Observation/cbc-hemoglobin, Observation/cbc-leukocytes, Observation/cbc-mch, Observation/cbc-mchc, Observation/cbc-mcv, Observation/cbc-platelets, Observation/dxa-femur-l-armass-bmd, Observation/dxa-femur-l-t-score-bmd, Observation/dxa-femur-l-z-score-bmd, Observation/dxa-hip-l-armass-bmd, Observation/dxa-hip-l-t-score-bmd, Observation/dxa-hip-l-z-score-bmd, Observation/exercise-per-day, Observation/exercise-per-week, Observation/head-circumference, Observation/heart-rate, Observation/height, Observation/length, Observation/ofc-percentile, Observation/oxygen-saturation, Observation/p-r-interval-ekg-lead, Observation/pack-years-example, Observation/pediatric-bmi-example, Observation/pediatric-wt-example, Observation/q-t-interval-ekg-lead, Observation/qrs-dur-ekg-lead, Observation/respiratory-rate, Observation/satO2-fiO2, Observation/serum-bun, Observation/serum-calcium, Observation/serum-chloride, Observation/serum-co2, Observation/serum-creatinine, Observation/serum-glucose, Observation/serum-potassium, Observation/serum-sodium, Observation/temperature, Observation/urobilinogen, Observation/weight, USCoreBodyHeightProfile, USCoreBodyTemperatureProfile, USCoreBodyWeightProfile, USCoreHeadCircumferenceProfile, USCoreMedicationDispenseProfile, USCoreMedicationRequestProfile, USCoreSmokingStatusProfile and USCoreVitalSignsProfile
• This material contains content from LOINC. LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
  Show Usage
  • LOINC: AUDIT_C, Bundle/docref-example-1... Show 202 more, Bundle/docref-example-2, DiagnosticReport/bone-density-report, DiagnosticReport/cardiology-report, DiagnosticReport/cbc, DiagnosticReport/chest-xray-report, DiagnosticReport/metabolic-panel, DocumentReference/adi-dnr, DocumentReference/discharge-summary, DocumentReference/episode-summary, DocumentReference/living-will, DocumentReference/polst, ExerciseVitalSign, HungerVitalSignExample, Observation/10-minute-apgar-color, Observation/10-minute-apgar-heart-rate, Observation/10-minute-apgar-muscle-tone, Observation/10-minute-apgar-reflex-irritability, Observation/10-minute-apgar-respiratory-effort, Observation/10-minute-apgar-score, Observation/10-minute-apgar-score-panel, Observation/ADI-example, Observation/AHC-HRSN-item-example-68517-2, Observation/AUDIT-C-item-example-68517-2, Observation/AUDIT-C-item-example-68519-8, Observation/AUDIT-C-item-example-68520-6, Observation/AUDIT-C-item-example-75626-2, Observation/AUDIT-C-panel-example-72109-2, Observation/EVS-item-example-68516-4, Observation/EVS-item-example-89555-7, Observation/EVS-panel-example-89574-8, Observation/HVS-item-example-88122-7, Observation/HVS-item-example-88123-5, Observation/HVS-item-example-88124-3, Observation/HVS-panel-example-88121-9, Observation/PHQ9-item-example-44250-9, Observation/PHQ9-item-example-44251-7, Observation/PHQ9-item-example-44252-5, Observation/PHQ9-item-example-44253-3, Observation/PHQ9-item-example-44254-1, Observation/PHQ9-item-example-44255-8, Observation/PHQ9-item-example-44258-2, Observation/PHQ9-item-example-44259-0, Observation/PHQ9-item-example-44260-8, Observation/PHQ9-item-example-44261-6, Observation/PHQ9-item-example-69722-7, Observation/PHQ9-panel-example-44249-1, Observation/PRAPARE-item-example-54899-0, Observation/PRAPARE-item-example-56051-6, Observation/PRAPARE-item-example-56799-0, Observation/PRAPARE-item-example-63512-8, Observation/PRAPARE-item-example-63586-2, Observation/PRAPARE-item-example-67875-5, Observation/PRAPARE-item-example-71802-3, Observation/PRAPARE-item-example-76437-3, Observation/PRAPARE-item-example-76501-6, Observation/PRAPARE-item-example-82589-3, Observation/PRAPARE-item-example-93026-3, Observation/PRAPARE-item-example-93027-1, Observation/PRAPARE-item-example-93028-9, Observation/PRAPARE-item-example-93029-7, Observation/PRAPARE-item-example-93030-5, Observation/PRAPARE-item-example-93033-9, Observation/PRAPARE-item-example-93034-7, Observation/PRAPARE-item-example-93035-4, Observation/PRAPARE-item-example-93038-8, Observation/PRAPARE-multiselect-item-example-32624-9-answer0, Observation/PRAPARE-multiselect-item-example-32624-9-answer1, Observation/PRAPARE-multiselect-item-example-93031-3-answer0, Observation/PRAPARE-multiselect-item-example-93031-3-answer1, Observation/PRAPARE-panel-example-93025-5, Observation/PRAPARE-panel-example-93039-6, Observation/PRAPARE-panel-example-93040-4, Observation/PRAPARE-panel-example-93041-2, Observation/PRAPARE-panel-example-93042-0, Observation/PRAPARE-panel-example-93043-8, Observation/TAPS-item-example-75889-6, Observation/TAPS-item-example-88037-7, Observation/TAPS-item-example-96842-0, Observation/TAPS-item-example-96843-8, Observation/TAPS-item-example-96844-6, Observation/TAPS-panel-example-96841-2, Observation/alcohol-use-status, Observation/alcoholic-drinks-per-day, Observation/at-home-in-vitro-test, Observation/average-blood-pressure, Observation/blood-pressure, Observation/bmi, Observation/bp-data-absent, Observation/capillary-refill-time-nail-bed, Observation/care-experience-preference, Observation/cbc-erythrocytes, Observation/cbc-hematocrit, Observation/cbc-hemoglobin, Observation/cbc-leukocytes, Observation/cbc-mch, Observation/cbc-mchc, Observation/cbc-mcv, Observation/cbc-platelets, Observation/dxa-femur-l-armass-bmd, Observation/dxa-femur-l-t-score-bmd, Observation/dxa-femur-l-z-score-bmd, Observation/dxa-hip-l-armass-bmd, Observation/dxa-hip-l-t-score-bmd, Observation/dxa-hip-l-z-score-bmd, Observation/e-cig-user, Observation/ekg-impression, Observation/ekg-lead, Observation/exercise-per-day, Observation/exercise-per-week, Observation/head-circumference, Observation/heart-rate, Observation/heart-rate-rhythm, Observation/height, Observation/jugular-vein-distension, Observation/length, Observation/no-ADI-example, Observation/observation-occupation, Observation/observation-occupation-industry-unknown, Observation/observation-occupation-unknown, Observation/ofc-percentile, Observation/oxygen-saturation, Observation/p-r-interval-ekg-lead, Observation/pediatric-bmi-example, Observation/pediatric-wt-example, Observation/pregnancy-intent, Observation/pregnancy-status, Observation/pulse-intensity-palpation, Observation/q-t-interval-ekg-lead, Observation/qrs-dur-ekg-lead, Observation/respiratory-rate, Observation/satO2-fiO2, Observation/serum-bun, Observation/serum-calcium, Observation/serum-chloride, Observation/serum-co2, Observation/serum-creatinine, Observation/serum-glucose, Observation/serum-potassium, Observation/serum-sodium, Observation/simple-observation-cognitive-status, Observation/simple-observation-disability-status, Observation/simple-observation-functional-status, Observation/some-day-smoker, Observation/temperature, Observation/treatment-intervention-preference, Observation/urobilinogen, Observation/weight, Observation/xray-chest-findings, Observation/xray-chest-impression, PHQ9Example, PRAPAREExample, QuestionnaireResponse/AUDIT-C, QuestionnaireResponse/TAPS, QuestionnaireResponse/hunger-vital-sign-example, QuestionnaireResponse/phq-9-example, QuestionnaireResponse/prapare-example, ServiceRequest/bmp, ServiceRequest/cbc, ServiceRequest/chest-xray, ServiceRequest/ekg, ServiceRequest/servicerequest-dnr-example1, TAPS, USCoreADIDocumentReferenceProfile, USCoreAverageBloodPressureProfile, USCoreBMIProfile, USCoreBloodPressureProfile, USCoreBodyHeightProfile, USCoreBodyTemperatureProfile, USCoreBodyWeightProfile, USCoreCareExperiencePreferenceProfile, USCoreClinicalNoteType, USCoreDiagnosticReportCategory, USCoreDiagnosticReportProfileLaboratoryReporting, USCoreDiagnosticReportProfileNoteExchange, USCoreDocumentReferenceProfile, USCoreDocumentReferenceType, USCoreFetchDocumentReference, USCoreGoalCodes, USCoreGoalProfile, USCoreHeadCircumferenceProfile, USCoreHeartRateProfile, USCoreInterpreterNeededExtension, USCoreLaboratoryResultObservationProfile, USCoreLaboratoryTestCodes, USCoreMedicationAdherenceExtension, USCoreNonLaboratoryCodes, USCoreObservationADIDocumentationProfile, USCoreObservationOccupationProfile, USCoreObservationPregnancyIntentProfile, USCoreObservationPregnancyStatusProfile, USCoreObservationScreeningAssessmentProfile, USCoreObservationSexualOrientationProfile, USCorePediatricBMIforAgeObservationProfile, USCorePediatricHeadOccipitalFrontalCircumferencePercentileProfile, USCorePediatricWeightForHeightObservationProfile, USCoreProcedureCodes, USCoreProcedureProfile, USCorePulseOximetryProfile, USCoreRespiratoryRateProfile, USCoreServiceRequestProfile, USCoreTreatmentInterventionPreferenceProfile and USCoreVitalSignsProfile
• This material contains content that is copyright of SNOMED International. Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/get-snomed or info@snomed.org.
  Show Usage
  • SNOMED Clinical Terms® (SNOMED CT®): AllergyIntolerance/example, AllergyIntolerance/non-pharmacologic-agent-example... Show 75 more, Bundle/allergyintolerance-provenance-example1, Bundle/allergyintolerance-provenance-example2, CarePlan/careplan-ulcer-example, Condition/condition-SDOH-example, Condition/condition-duodenal-ulcer, Condition/condition-duodenal-ulcer-res, Condition/encounter-diagnosis-example1, Condition/encounter-diagnosis-example2, Condition/health-concern-example, Device/udi-2, Device/udi-3, Device/udi-4, Device/udi-5, Encounter/1036, Encounter/delivery, Encounter/example-1, FamilyMemberHistory/familymemberhistory-example, Goal/goal-sdoh-2, Holy Family Hospital, Media/chest-xray, MedicationRequest/medicationrequest-coded-oral-axid, MedicationRequest/medicationrequest-contained-oral-axid, MedicationRequest/medicationrequest-referenced-oral-axid, MedicationRequest/self-tylenol, Observation/10-minute-apgar-score-panel, Observation/ADI-example, Observation/alcohol-use-status, Observation/at-home-in-vitro-test, Observation/average-blood-pressure, Observation/e-cig-user, Observation/no-ADI-example, Observation/pack-years-example, Observation/pregnancy-intent, Observation/pregnancy-status, Observation/simple-observation-functional-status, Observation/simple-observation-sdoh, Observation/some-day-smoker, Observation/substance-use-status, Patient/child-example, Patient/deceased-example, Patient/example, Patient/infant-example, Procedure/rehab, ServiceRequest/bmp, ServiceRequest/cbc, ServiceRequest/chest-xray, ServiceRequest/ekg, ServiceRequest/foodpantry-referral, ServiceRequest/rehab, ServiceRequest/servicerequest-dnr-example1, Specimen/example-serum-lipemic, Specimen/specimen-example-serum, Specimen/specimen-example-urine, Specimen/specimen-example-whole-blood, US-Core example CareTeam, USCoreAllergyIntolerance, USCoreCarePlanProfile, USCoreConditionCodes, USCoreConditionCodesCurrent, USCoreConditionEncounterDiagnosisProfile, USCoreConditionProblemsHealthConcernsProfile, USCoreDeviceProfile, USCoreFamilyMemberHistoryProfile, USCoreGoalCodes, USCoreGoalProfile, USCoreImmunizationProfile, USCoreIndividualSexExtension, USCoreMedicationRequestProfile, USCoreObservationPregnancyIntentProfile, USCoreProcedureCodes, USCoreProcedureProfile, USCoreServiceRequestCategoryCodes, USCoreServiceRequestProfile, USCoreSmokingStatusProfile and USCoreSpecimenProfile
• This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html
  Show Usage
  • AllergyIntolerance Clinical Status Codes: AllergyIntolerance/example, AllergyIntolerance/non-pharmacologic-agent-example, Bundle/allergyintolerance-provenance-example1, Bundle/allergyintolerance-provenance-example2 and USCoreAllergyIntolerance
  • AllergyIntolerance Verification Status: AllergyIntolerance/example, AllergyIntolerance/non-pharmacologic-agent-example, Bundle/allergyintolerance-provenance-example1, Bundle/allergyintolerance-provenance-example2 and USCoreAllergyIntolerance
  • Condition Category Codes: Condition/condition-SDOH-example, Condition/condition-duodenal-ulcer... Show 6 more, Condition/condition-duodenal-ulcer-res, Condition/encounter-diagnosis-example1, Condition/encounter-diagnosis-example2, USCoreConditionEncounterDiagnosisProfile, USCoreConditionProblemsHealthConcernsProfile and USCoreProblemOrHealthConcern
  • Condition Clinical Status Codes: Condition/condition-SDOH-example, Condition/condition-duodenal-ulcer, Condition/condition-duodenal-ulcer-res, Condition/health-concern-example and USCoreConditionProblemsHealthConcernsProfile
  • ConditionVerificationStatus: Condition/condition-SDOH-example, Condition/condition-duodenal-ulcer, Condition/condition-duodenal-ulcer-res, Condition/health-concern-example and USCoreConditionProblemsHealthConcernsProfile
  • Coverage Class Codes: Coverage/coverage-example and USCoreCoverageProfile
  • DataAbsentReason: Observation/bp-data-absent, Observation/observation-occupation-unknown and US-Core example CareTeam
  • Endpoint Connection Type: Bundle/66c8856b-ba11-4876-8aa8-467aad8c11a2 and Saint Luke's Hospital of Kansas City
  • LibraryType: USCore
  • MedicationRequest Category Codes: USCoreMedicationRequestProfile
  • Observation Category Codes: Observation/10-minute-apgar-color, Observation/10-minute-apgar-heart-rate... Show 145 more, Observation/10-minute-apgar-muscle-tone, Observation/10-minute-apgar-reflex-irritability, Observation/10-minute-apgar-respiratory-effort, Observation/10-minute-apgar-score, Observation/10-minute-apgar-score-panel, Observation/AHC-HRSN-item-example-68517-2, Observation/AUDIT-C-item-example-68517-2, Observation/AUDIT-C-item-example-68519-8, Observation/AUDIT-C-item-example-68520-6, Observation/AUDIT-C-item-example-75626-2, Observation/AUDIT-C-panel-example-72109-2, Observation/EVS-item-example-68516-4, Observation/EVS-item-example-89555-7, Observation/EVS-panel-example-89574-8, Observation/HVS-item-example-88122-7, Observation/HVS-item-example-88123-5, Observation/HVS-item-example-88124-3, Observation/HVS-panel-example-88121-9, Observation/PHQ9-item-example-44250-9, Observation/PHQ9-item-example-44251-7, Observation/PHQ9-item-example-44252-5, Observation/PHQ9-item-example-44253-3, Observation/PHQ9-item-example-44254-1, Observation/PHQ9-item-example-44255-8, Observation/PHQ9-item-example-44258-2, Observation/PHQ9-item-example-44259-0, Observation/PHQ9-item-example-44260-8, Observation/PHQ9-item-example-44261-6, Observation/PHQ9-item-example-69722-7, Observation/PHQ9-panel-example-44249-1, Observation/PRAPARE-item-example-54899-0, Observation/PRAPARE-item-example-56051-6, Observation/PRAPARE-item-example-56799-0, Observation/PRAPARE-item-example-63512-8, Observation/PRAPARE-item-example-63586-2, Observation/PRAPARE-item-example-67875-5, Observation/PRAPARE-item-example-71802-3, Observation/PRAPARE-item-example-76437-3, Observation/PRAPARE-item-example-76501-6, Observation/PRAPARE-item-example-82589-3, Observation/PRAPARE-item-example-93026-3, Observation/PRAPARE-item-example-93027-1, Observation/PRAPARE-item-example-93028-9, Observation/PRAPARE-item-example-93029-7, Observation/PRAPARE-item-example-93030-5, Observation/PRAPARE-item-example-93033-9, Observation/PRAPARE-item-example-93034-7, Observation/PRAPARE-item-example-93035-4, Observation/PRAPARE-item-example-93038-8, Observation/PRAPARE-multiselect-item-example-32624-9-answer0, Observation/PRAPARE-multiselect-item-example-32624-9-answer1, Observation/PRAPARE-multiselect-item-example-93031-3-answer0, Observation/PRAPARE-multiselect-item-example-93031-3-answer1, Observation/PRAPARE-panel-example-93025-5, Observation/PRAPARE-panel-example-93039-6, Observation/PRAPARE-panel-example-93040-4, Observation/PRAPARE-panel-example-93041-2, Observation/PRAPARE-panel-example-93042-0, Observation/PRAPARE-panel-example-93043-8, Observation/TAPS-item-example-75889-6, Observation/TAPS-item-example-88037-7, Observation/TAPS-item-example-96842-0, Observation/TAPS-item-example-96843-8, Observation/TAPS-item-example-96844-6, Observation/TAPS-panel-example-96841-2, Observation/alcohol-use-status, Observation/alcoholic-drinks-per-day, Observation/at-home-in-vitro-test, Observation/average-blood-pressure, Observation/blood-pressure, Observation/bmi, Observation/bp-data-absent, Observation/capillary-refill-time-nail-bed, Observation/cbc-erythrocytes, Observation/cbc-hematocrit, Observation/cbc-hemoglobin, Observation/cbc-leukocytes, Observation/cbc-mch, Observation/cbc-mchc, Observation/cbc-mcv, Observation/cbc-platelets, Observation/dxa-femur-l-armass-bmd, Observation/dxa-femur-l-t-score-bmd, Observation/dxa-femur-l-z-score-bmd, Observation/dxa-hip-l-armass-bmd, Observation/dxa-hip-l-t-score-bmd, Observation/dxa-hip-l-z-score-bmd, Observation/e-cig-user, Observation/ekg-impression, Observation/ekg-lead, Observation/exercise-per-day, Observation/exercise-per-week, Observation/head-circumference, Observation/heart-rate, Observation/heart-rate-rhythm, Observation/height, Observation/jugular-vein-distension, Observation/length, Observation/observation-occupation, Observation/observation-occupation-industry-unknown, Observation/observation-occupation-unknown, Observation/ofc-percentile, Observation/oxygen-saturation, Observation/p-r-interval-ekg-lead, Observation/pack-years-example, Observation/pediatric-bmi-example, Observation/pediatric-wt-example, Observation/pregnancy-intent, Observation/pregnancy-status, Observation/pulse-intensity-palpation, Observation/q-t-interval-ekg-lead, Observation/qrs-dur-ekg-lead, Observation/respiratory-rate, Observation/satO2-fiO2, Observation/serum-bun, Observation/serum-calcium, Observation/serum-chloride, Observation/serum-co2, Observation/serum-creatinine, Observation/serum-glucose, Observation/serum-potassium, Observation/serum-sodium, Observation/some-day-smoker, Observation/substance-use-status, Observation/temperature, Observation/urobilinogen, Observation/weight, Observation/xray-chest-findings, Observation/xray-chest-impression, USCoreCareExperiencePreferenceProfile, USCoreClinicalResultObservationCategory, USCoreConditionProblemsHealthConcernsProfile, USCoreLaboratoryResultObservationProfile, USCoreObservationADIDocumentationProfile, USCoreObservationClinicalResultProfile, USCoreObservationOccupationProfile, USCoreObservationPregnancyIntentProfile, USCoreObservationPregnancyStatusProfile, USCoreObservationScreeningAssessmentProfile, USCoreScreeningAssessmentObservationCategory, USCoreScreeningAssessmentObservationMaximumCategory, USCoreSimpleObservationCategory, USCoreSimpleObservationProfile, USCoreSmokingStatusProfile and USCoreTreatmentInterventionPreferenceProfile
  • Organization type: Acme Clinic, Acme Health Plan, Acme Labs and Holy Healthcare
  • Provenance participant type: Bundle/allergyintolerance-provenance-example1, Bundle/allergyintolerance-provenance-example2 and USCoreProvenance
  • Observation Reference Range Meaning Codes: Observation/cbc-erythrocytes, Observation/cbc-hematocrit... Show 14 more, Observation/cbc-hemoglobin, Observation/cbc-leukocytes, Observation/cbc-mch, Observation/cbc-mchc, Observation/cbc-mcv, Observation/cbc-platelets, Observation/serum-bun, Observation/serum-calcium, Observation/serum-chloride, Observation/serum-co2, Observation/serum-creatinine, Observation/serum-glucose, Observation/serum-potassium and Observation/serum-sodium
  • SubscriberPolicyholder Relationship Codes: Coverage/coverage-example and USCoreCoverageProfile
  • UsageContextType: PRAPAREExample
  • diagnosticServiceSectionId: DiagnosticReport/cbc, DiagnosticReport/metabolic-panel and USCoreDiagnosticReportProfileLaboratoryReporting
  • identifierType: Bundle/66c8856b-ba11-4876-8aa8-467aad8c11a2, Coverage/coverage-example... Show 5 more, Patient/child-example, Patient/deceased-example, Patient/example, Patient/infant-example and USCoreCoverageProfile
  • specimenType: Specimen/example-serum-lipemic, Specimen/specimen-example-serum, Specimen/specimen-example-urine and Specimen/specimen-example-whole-blood
  • ActCode: Coverage/coverage-example, Encounter/1036... Show 4 more, Encounter/delivery, Encounter/example-1, MedicationDispense/medicationdispense-example and USCoreMedicationDispenseProfile
  • ActReason: USCoreImmunizationProfile
  • HL7 Document Format Codes: Bundle/docref-example-1, USCoreADIDocumentReferenceProfile and USCoreDocumentReferenceProfile
  • NullFlavor: USCoreDocumentReferenceProfile and USCoreDocumentReferenceType
  • ObservationInterpretation: Observation/cbc-erythrocytes, Observation/cbc-hematocrit... Show 17 more, Observation/cbc-hemoglobin, Observation/cbc-leukocytes, Observation/cbc-mch, Observation/cbc-mchc, Observation/cbc-mcv, Observation/cbc-platelets, Observation/satO2-fiO2, Observation/serum-bun, Observation/serum-calcium, Observation/serum-chloride, Observation/serum-co2, Observation/serum-creatinine, Observation/serum-glucose, Observation/serum-potassium, Observation/serum-sodium, Observation/urobilinogen and USCoreLaboratoryResultObservationProfile
  • ParticipationFunction: Bundle/66c8856b-ba11-4876-8aa8-467aad8c11a2
  • RoleCode: FamilyMemberHistory/familymemberhistory-example, Holy Family Hospital... Show 5 more, MedicationRequest/self-tylenol, RelatedPerson/shaw-niece, USCoreFamilyMemberHistoryProfile, USCoreLocationProfile and USCoreRelatedPersonProfile
  • TribalEntityUS: Patient/example and USCoreTribalAffiliationExtension
• Used by permission of HL7 International, all rights reserved Creative Commons License
  Show Usage
  • US Core Condition Category Extension Codes: Condition/health-concern-example, USCoreConditionProblemsHealthConcernsProfile and USCoreProblemOrHealthConcern
  • US Core Category: Condition/condition-SDOH-example, Observation/ADI-example... Show 69 more, Observation/AHC-HRSN-item-example-68517-2, Observation/HVS-item-example-88122-7, Observation/HVS-item-example-88123-5, Observation/HVS-item-example-88124-3, Observation/HVS-panel-example-88121-9, Observation/PHQ9-item-example-44250-9, Observation/PHQ9-item-example-44251-7, Observation/PHQ9-item-example-44252-5, Observation/PHQ9-item-example-44253-3, Observation/PHQ9-item-example-44254-1, Observation/PHQ9-item-example-44255-8, Observation/PHQ9-item-example-44258-2, Observation/PHQ9-item-example-44259-0, Observation/PHQ9-item-example-44260-8, Observation/PHQ9-item-example-44261-6, Observation/PHQ9-item-example-69722-7, Observation/PHQ9-panel-example-44249-1, Observation/PRAPARE-item-example-54899-0, Observation/PRAPARE-item-example-56051-6, Observation/PRAPARE-item-example-56799-0, Observation/PRAPARE-item-example-63512-8, Observation/PRAPARE-item-example-63586-2, Observation/PRAPARE-item-example-67875-5, Observation/PRAPARE-item-example-71802-3, Observation/PRAPARE-item-example-76437-3, Observation/PRAPARE-item-example-76501-6, Observation/PRAPARE-item-example-82589-3, Observation/PRAPARE-item-example-93026-3, Observation/PRAPARE-item-example-93027-1, Observation/PRAPARE-item-example-93028-9, Observation/PRAPARE-item-example-93029-7, Observation/PRAPARE-item-example-93030-5, Observation/PRAPARE-item-example-93033-9, Observation/PRAPARE-item-example-93034-7, Observation/PRAPARE-item-example-93035-4, Observation/PRAPARE-item-example-93038-8, Observation/PRAPARE-multiselect-item-example-32624-9-answer0, Observation/PRAPARE-multiselect-item-example-32624-9-answer1, Observation/PRAPARE-multiselect-item-example-93031-3-answer0, Observation/PRAPARE-multiselect-item-example-93031-3-answer1, Observation/PRAPARE-panel-example-93025-5, Observation/PRAPARE-panel-example-93039-6, Observation/PRAPARE-panel-example-93040-4, Observation/PRAPARE-panel-example-93041-2, Observation/PRAPARE-panel-example-93042-0, Observation/PRAPARE-panel-example-93043-8, Observation/care-experience-preference, Observation/no-ADI-example, Observation/simple-observation-cognitive-status, Observation/simple-observation-disability-status, Observation/simple-observation-functional-status, Observation/simple-observation-sdoh, Observation/treatment-intervention-preference, PRAPAREExample, ServiceRequest/foodpantry-referral, ServiceRequest/rehab, ServiceRequest/servicerequest-dnr-example1, USCoreCareExperiencePreferenceProfile, USCoreConditionProblemsHealthConcernsProfile, USCoreObservationADIDocumentationProfile, USCoreObservationScreeningAssessmentProfile, USCoreScreeningAssessmentConditionCategory, USCoreScreeningAssessmentObservationCategory, USCoreScreeningAssessmentObservationMaximumCategory, USCoreServiceRequestCategoryCodes, USCoreServiceRequestProfile, USCoreSimpleObservationCategory, USCoreSimpleObservationProfile and USCoreTreatmentInterventionPreferenceProfile
  • US Core DocumentReferences Category Codes: Bundle/docref-example-1, Bundle/docref-example-2... Show 4 more, DocumentReference/discharge-summary, DocumentReference/episode-summary, USCoreDocumentReferenceCategory and USCoreDocumentReferenceProfile
• Using RxNorm codes of type SAB=RXNORM as this specification describes does not require a UMLS license. Access to the full set of RxNorm definitions, and/or additional use of other RxNorm structures and information requires a UMLS license. The use of RxNorm in this specification is pursuant to HL7's status as a licensee of the NLM UMLS. HL7's license does not convey the right to use RxNorm to any users of this specification; implementers must acquire a license to use RxNorm in their own right.
  Show Usage
  • RxNorm: Medication/uscore-med1, Medication/uscore-med2... Show 4 more, MedicationDispense/medicationdispense-example, MedicationRequest/medicationrequest-coded-oral-axid, MedicationRequest/medicationrequest-contained-oral-axid and MedicationRequest/self-tylenol

Expansion Parameters

In HL7 FHIR, expansion parameters are special query parameters that you can pass to a ValueSet $expand operation to control and customize how the ValueSet is expanded (i.e., how the full list of codes/concepts is generated from the ValueSet definition). US Core uses the following parameters.

Parameter	Value
system-version	SNOMED CT[US]

Parameter Settings

The following IG Parameters are set for this Implementation Guide:

• code: copyrightyear
  value: 2026+
• code: releaselabel
  value: CI Build
• code: path-resource
  value: input/resources
• code: path-resource
  value: fsh-generated/resources
• code: path-pages
  value: input/pagecontent
• code: path-pages
  value: input/intro-notes
• code: path-liquid
  value: input/liquid
• code: path-expansion-params
  value: ../../input/_resources/exp-params.json
• code: active-tables
  value: false
• code: apply-contact
  value: true
• code: apply-jurisdiction
  value: true
• code: apply-publisher
  value: true
• code: apply-version
  value: true
• code: show-inherited-invariants
  value: false
• code: usage-stats-opt-out
  value: true
• code: suppressed-ids
  value: DocumentReference/discharge-summary
• code: tabbed-snapshots
  value: true
• code: no-narrative
  value: DocumentReference/discharge-summary
• code: no-narrative
  value: Bundle/docref-example-1
• code: no-narrative
  value: Bundle/docref-example-2
• code: version-comparison-master
  value: 8.0.1
• code: version-comparison
  value: 8.0.1
• code: version-comparison
  value: 7.0.0
• code: version-comparison
  value: 6.1.0
• code: version-comparison
  value: 5.0.1
• code: version-comparison
  value: 4.0.0
• code: version-comparison
  value: 3.1.1
• code: html-exempt
  value: comparison-argo/vs-observation-status-us-core-observation-smoking-status-status.html
• code: html-exempt
  value: comparison-argo/sd-argo-diagnosticreport-us-core-diagnosticreport-note.html
• code: html-exempt
  value: comparison-argo/vs-c80-doc-typecodes-us-core-documentreference-type.html
• code: html-exempt
  value: comparison-argo/sd-argo-procedure-us-core-procedure.html
• code: html-exempt
  value: comparison-argo/vs-medication-codes-2.16.840.1.113762.1.4.1010.4.html
• code: html-exempt
  value: comparison-argo/vs-condition-category-condition-category.html
• code: html-exempt
  value: comparison-argo/index.html
• code: html-exempt
  value: comparison-argo/vs-observation-ccdavitalsignresult-2.16.840.1.113883.3.88.12.80.62.html
• code: html-exempt
  value: comparison-argo/sd-argo-patient-us-core-patient.html
• code: html-exempt
  value: comparison-argo/vs-languages-Languages.html
• code: html-exempt
  value: comparison-argo/sd-argo-goal-us-core-goal.html
• code: html-exempt
  value: comparison-argo/vs-device-kind-device-kind.html
• code: html-exempt
  value: comparison-argo/sd-argo-medication-us-core-medication.html
• code: html-exempt
  value: comparison-argo/sd-argo-vitalsigns-us-core-vital-signs.html
• code: html-exempt
  value: comparison-argo/sd-argo-allergyintolerance-us-core-allergyintolerance.html
• code: html-exempt
  value: comparison-argo/sd-argo-condition-us-core-condition-encounter-diagnosis.html
• code: html-exempt
  value: comparison-argo/sd-argo-observationresults-us-core-observation-clinical-result.html
• code: html-exempt
  value: comparison-argo/sd-argo-documentreference-us-core-documentreference.html
• code: html-exempt
  value: comparison-argo/vs-formatcodes-v3-HL7FormatCodes.html
• code: html-exempt
  value: comparison-argo/sd-argo-birthsex-us-core-birthsex.html
• code: html-exempt
  value: comparison-argo/sd-argo-smokingstatus-us-core-smokingstatus.html
• code: html-exempt
  value: comparison-argo/sd-argo-immunization-us-core-immunization.html
• code: html-exempt
  value: comparison-argo/sd-argo-diagnosticreport-us-core-diagnosticreport-lab.html
• code: html-exempt
  value: comparison-argo/vs-report-codes-us-core-diagnosticreport-report-and-note-codes.html
• code: html-exempt
  value: comparison-argo/sd-argo-condition-us-core-condition-problems-health-concerns.html
• code: html-exempt
  value: comparison-argo/sd-argo-device-us-core-implantable-device.html
• code: html-exempt
  value: comparison-argo/sd-argo-race-us-core-race.html
• code: html-exempt
  value: comparison-argo/vs-observation-codes-us-core-laboratory-test-codes.html
• code: html-exempt
  value: comparison-argo/vs-procedure-type-us-core-procedure-code.html
• code: html-exempt
  value: comparison-argo/vs-observation-codes-2.16.840.1.113762.1.4.1267.6.html
• code: html-exempt
  value: comparison-argo/sd-argo-careplan-us-core-careplan.html
• code: html-exempt
  value: comparison-argo/vs-report-codes-us-core-laboratory-test-codes.html
• code: html-exempt
  value: comparison-argo/vs-vacc-status-immunization-status.html
• code: html-exempt
  value: comparison-argo/sd-argo-observationresults-us-core-observation-lab.html
• code: html-exempt
  value: comparison-argo/sd-argo-ethnicity-us-core-ethnicity.html
• code: html-exempt
  value: comparison-argo/vs-narrative-status-us-core-narrative-status.html
• code: ipa-comparison
  value: {current}
• code: ips-comparison
  value: {current}
• code: auto-oid-root
  value: 2.16.840.1.113883.4.642.40.2
• code: fmm-definition
  value: changes-between-versions.html#us-core-maturity-levels
• code: path-history
  value: http://hl7.org/fhir/us/core/history.html