US Core Implementation Guide
9.0.0 - CI Build 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 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

Terminology

Page standards status: Trial-use

This page lists all the ValueSets, CodeSystems, and ConceptMaps defined as part of the US Core Implementation Guide. For more information on using codes in US Core, see the FHIR Terminology section in the FHIR specification and the Coded Elements section in this guide.

US Core ValueSet and CodeSystem versions

Terminology is central to US Core. Code systems and value sets change over time, independent of or due to the US Core's annual updates. These changes include adding, deprecating, or retiring code, as well as updating code definitions. In large code systems or value sets, these changes may go unnoticed; however, for smaller enumerated terminologies, they can be obvious and lead to breaking changes.

Every published version of US Core also publishes a snapshot of the latest versions of code systems and value sets, along with their expansions, at the time of publication. However, US Core does not "pin" the terminology to a specific version of US Core, so the canonical references point to their latest versions. For example, in US Core version 6.1.0, the US Core Laboratory Test Codes link to version 6.1.0 of the ValueSet. However, its canonical URI, http://hl7.org/fhir/us/core/ValueSet/us-core-laboratory-test-codes, resolves to the latest published version of the valueset; in other words, it links to this version of US Core's valueset. The "Unpinned" terminology more accurately reflects real-world usage of US Core. When implementing US Core, implementers should use the published versions or later versions of the value sets and code systems. In some cases, implementers may need to use terminology from earlier versions to preserve legacy data.

Value Set Packages

The packages will be available by the US Core 9.0.0 publication date.

A Value Set Package contains all the expanded value sets required for an implementation guide. In addition to the packages published with US Core, annual value set packages containing value sets expanded with the updated code system versions will be available for the following US Core Versions to assist implementers who require them.

US Core 6.1.0 (published June 2023)

US Core 8.0.1 (published June 2025)

US Core 9.0.0 (published June 2026)

For more information on Value Set Package and how they are created and used, see the Value Set Package Implementation Guide

Value Sets

Most value sets used in this guide are defined in the base FHIR specification, HL7 Terminology (THO), or the Value Set Authority Center (VSAC). However, US Core also defines several value sets and they are listed below.

Value sets in US Core and C-CDA may retain inactive codes. These codes may be useful for historical queries but are not recommended for new data. Implementers should note that some code systems exclude inactive codes from current expansions; if needed, these codes may be accessible through prior expansions via terminology services. HL7 recommends validators allow non-active codes with note on their status.

Value Sets Used in US Core

The following table lists all the Value sets used in US Core and where they can be found. This information is also available as a csv or excel file.

Value Set Sources:

Row # Value Set Profiles Where Used Source
1 Common UCUM units StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
2 ActEncounterCode StructureDefinition/us-core-encounter THO
3 ActPharmacySupplyType StructureDefinition/us-core-medicationdispense THO
4 ActPriority StructureDefinition/us-core-encounter THO
5 ActSubstanceAdminSubstitutionCode StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
THO
6 AddressType StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-location
StructureDefinition/us-core-organization
FHIR
7 AddressUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-location
StructureDefinition/us-core-organization
FHIR
8 AdministrativeGender StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-familymemberhistory
StructureDefinition/us-core-relatedperson
FHIR
9 Admit source StructureDefinition/us-core-encounter FHIR
10 Advance Healthcare Directive Categories LOINC StructureDefinition/us-core-adi-documentreference VSAC
11 Advance Healthcare Directive Document Types Grouper StructureDefinition/us-core-adi-documentreference VSAC
12 Allergen Concepts (Medications and Environmental Substances) including refutations. VSAC
13 AllergyIntolerance Clinical Status Codes StructureDefinition/us-core-allergyintolerance FHIR
14 AllergyIntolerance Verification Status Codes StructureDefinition/us-core-allergyintolerance FHIR
15 AllergyIntoleranceCategory StructureDefinition/us-core-allergyintolerance FHIR
16 AllergyIntoleranceCriticality StructureDefinition/us-core-allergyintolerance FHIR
17 AllergyIntoleranceSeverity StructureDefinition/us-core-allergyintolerance FHIR
18 AllergyIntoleranceType StructureDefinition/us-core-allergyintolerance FHIR
19 Answer Set with Yes No and Unknowns StructureDefinition/us-core-interpreter-needed
StructureDefinition/us-core-observation-adi-documentation
VSAC
20 Birth Sex StructureDefinition/us-core-birthsex VSAC
21 Body Length Units StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
FHIR
22 Body Temperature Units StructureDefinition/us-core-body-temperature FHIR
23 Body Weight Units StructureDefinition/us-core-body-weight FHIR
24 CMS Place of Service Codes (POS) ValueSet/us-core-location-type THO
25 CVX Vaccines Administered Vaccine Set StructureDefinition/us-core-immunization VSAC
26 Care Plan Activity Kind StructureDefinition/us-core-careplan FHIR
27 Care Plan Activity Outcome StructureDefinition/us-core-careplan FHIR
28 Care Plan Category StructureDefinition/us-core-careplan FHIR
29 Care Plan Intent StructureDefinition/us-core-careplan FHIR
30 Care Team Member Function ValueSet/us-core-practitionerrole-specialty
StructureDefinition/us-core-careteam
StructureDefinition/us-core-practitionerrole
VSAC
31 Care Team category StructureDefinition/us-core-careteam FHIR
32 CarePlanActivityStatus StructureDefinition/us-core-careplan FHIR
33 CareTeamStatus StructureDefinition/us-core-careteam FHIR
34 Codes for Immunization Site of Administration StructureDefinition/us-core-immunization FHIR
35 Common Languages StructureDefinition/us-core-specimen
StructureDefinition/us-core-documentreference
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/us-core-procedure
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-careplan
StructureDefinition/us-core-organization
StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-practitioner
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-patient
StructureDefinition/us-core-provenance
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-questionnaireresponse
StructureDefinition/us-core-condition-encounter-diagnosis
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-device
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-encounter
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-coverage
StructureDefinition/us-core-servicerequest
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medication
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-goal
StructureDefinition/us-core-careteam
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-familymemberhistory
StructureDefinition/us-core-immunization
StructureDefinition/us-core-relatedperson
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-location
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-allergyintolerance
StructureDefinition/us-core-blood-pressure
FHIR
36 Common Tags StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-encounter
StructureDefinition/us-core-observation-lab
FHIR
37 CompositionStatus StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
38 Condition Category Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
39 Condition Clinical Status Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
40 Condition Outcome Codes StructureDefinition/us-core-familymemberhistory FHIR
41 Condition Stage StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
42 Condition Stage Type StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
43 Condition/Diagnosis Severity StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
44 Condition/Problem/Diagnosis Codes StructureDefinition/us-core-procedure FHIR
45 ConditionVerificationStatus StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
46 Contact entity type StructureDefinition/us-core-organization FHIR
47 ContactPointSystem StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-organization
FHIR
48 ContactPointUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-organization
FHIR
49 Coverage Class Codes StructureDefinition/us-core-coverage FHIR
50 Coverage Copay Type Codes StructureDefinition/us-core-coverage FHIR
51 DataAbsentReason StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
52 DaysOfWeek StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-location
FHIR
53 Detailed Ethnicity Including Absence Reasons StructureDefinition/us-core-ethnicity VSAC
54 Detailed race including absence reasons. StructureDefinition/us-core-race VSAC
55 DeviceNameType StructureDefinition/us-core-device FHIR
56 DiagnosisRole StructureDefinition/us-core-encounter FHIR
57 Diagnostic Service Section Codes StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
FHIR
58 DiagnosticReportStatus StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
FHIR
59 Diet StructureDefinition/us-core-encounter FHIR
60 Document Class Value Set StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
61 Document Type Value Set OperationDefinition/docref FHIR
62 DocumentReferenceStatus StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
63 DocumentRelationshipType StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
64 DoseAndRateType StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
65 Encounter Reason Codes StructureDefinition/us-core-encounter FHIR
66 Encounter Type StructureDefinition/us-core-encounter VSAC
67 EncounterLocationStatus StructureDefinition/us-core-encounter FHIR
68 EncounterStatus StructureDefinition/us-core-encounter FHIR
69 Ethnicity Categories StructureDefinition/us-core-ethnicity VSAC
70 EventStatus StructureDefinition/us-core-procedure FHIR
71 Example Coverage Financial Exception Codes StructureDefinition/us-core-coverage FHIR
72 FHIR Device Types StructureDefinition/us-core-procedure
StructureDefinition/us-core-device
FHIR
73 FHIR Specimen Collection Method StructureDefinition/us-core-specimen FHIR
74 FHIRDeviceStatus StructureDefinition/us-core-device FHIR
75 FHIRDeviceStatusReason StructureDefinition/us-core-device FHIR
76 Facility Type Code Value Set StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
77 Family Member Value StructureDefinition/us-core-familymemberhistory VSAC
78 FamilyHistoryAbsentReason StructureDefinition/us-core-familymemberhistory FHIR
79 FamilyHistoryStatus StructureDefinition/us-core-familymemberhistory FHIR
80 Federal Administrative Sex StructureDefinition/us-core-individual-sex VSAC
81 Financial Resource Status Codes StructureDefinition/us-core-coverage FHIR
82 Gender Identity StructureDefinition/us-core-genderIdentity VSAC
83 Goal achievement status StructureDefinition/us-core-goal FHIR
84 Goal category StructureDefinition/us-core-goal FHIR
85 Goal priority StructureDefinition/us-core-goal FHIR
86 Goal start event StructureDefinition/us-core-goal FHIR
87 GoalLifecycleStatus StructureDefinition/us-core-goal FHIR
88 HL7 ValueSet of Format Codes for use with Document Sharing StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
THO
89 Healthcare Service Location Type Combined ValueSet/us-core-location-type VSAC
90 IdentifierType StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-encounter
StructureDefinition/us-core-coverage
StructureDefinition/us-core-organization
FHIR
91 IdentifierUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-encounter
StructureDefinition/us-core-coverage
StructureDefinition/us-core-organization
FHIR
92 Immunization Function Codes StructureDefinition/us-core-immunization FHIR
93 Immunization Funding Source StructureDefinition/us-core-immunization FHIR
94 Immunization Origin Codes StructureDefinition/us-core-immunization FHIR
95 Immunization Program Eligibility StructureDefinition/us-core-immunization FHIR
96 Immunization Reason Codes StructureDefinition/us-core-immunization FHIR
97 Immunization Route Codes StructureDefinition/us-core-immunization FHIR
98 Immunization Status Codes StructureDefinition/us-core-immunization FHIR
99 Immunization Status Reason Codes StructureDefinition/us-core-immunization FHIR
100 Immunization Subpotent Reason StructureDefinition/us-core-immunization FHIR
101 Immunization Target Disease Codes StructureDefinition/us-core-immunization FHIR
102 Industry NAICS Detail (ODH) StructureDefinition/us-core-observation-occupation PHINVADS
103 Information Source for Medication Adherence StructureDefinition/us-core-medication-adherence VSAC
104 LOINC Codes StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-goal
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-observation-adi-documentation
FHIR
105 Languages StructureDefinition/us-core-patient THO
106 LinkType StructureDefinition/us-core-patient FHIR
107 Location type StructureDefinition/us-core-encounter
StructureDefinition/us-core-location
FHIR
108 LocationMode StructureDefinition/us-core-location FHIR
109 LocationStatus StructureDefinition/us-core-location FHIR
110 Manifestation and Symptom Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
111 MaritalStatus StructureDefinition/us-core-patient FHIR
112 Medication status codes StructureDefinition/us-core-medication FHIR
113 Medication Adherence StructureDefinition/us-core-medication-adherence VSAC
114 Medication Clinical Drug StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medication
StructureDefinition/us-core-medicationdispense
VSAC
115 Medication dispense category codes StructureDefinition/us-core-medicationdispense FHIR
116 Medication dispense performer function codes StructureDefinition/us-core-medicationdispense FHIR
117 Medication dispense status codes StructureDefinition/us-core-medicationdispense FHIR
118 Medication dispense status reason codes StructureDefinition/us-core-medicationdispense FHIR
119 Medication request category codes StructureDefinition/us-core-medicationrequest FHIR
120 Medication request course of therapy codes StructureDefinition/us-core-medicationrequest FHIR
121 Medication request intent StructureDefinition/us-core-medicationrequest FHIR
122 Medication request status reason codes StructureDefinition/us-core-medicationrequest FHIR
123 Medicationrequest status StructureDefinition/us-core-medicationrequest FHIR
124 MimeType StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
125 NameUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
FHIR
126 Observation Category Codes StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-body-height
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-blood-pressure
FHIR
127 Observation Interpretation Codes StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
128 Observation Methods StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
129 Observation Reference Range Applies To Codes StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
130 Observation Reference Range Meaning Codes StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
131 ObservationStatus StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
132 Occupation ONETSOC Detail (ODH) StructureDefinition/us-core-observation-occupation PHINVADS
133 Organization type StructureDefinition/us-core-organization FHIR
134 Participant Roles StructureDefinition/us-core-servicerequest FHIR
135 Participant type StructureDefinition/us-core-encounter FHIR
136 Patient Contact Relationship StructureDefinition/us-core-patient FHIR
137 Payer Type StructureDefinition/us-core-coverage VSAC
138 Personal And Legal Relationship Role Type StructureDefinition/us-core-relatedperson VSAC
139 Practice Setting Code Value Set StructureDefinition/us-core-adi-documentreference
ValueSet/us-core-practitionerrole-specialty
StructureDefinition/us-core-documentreference
FHIR
140 Pregnancy Intention StructureDefinition/us-core-observation-pregnancyintent VSAC
141 Pregnancy Status Observation StructureDefinition/us-core-observation-pregnancystatus VSAC
142 Procedure Category Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
143 Procedure Codes (SNOMED CT) StructureDefinition/us-core-careplan FHIR
144 Procedure Device Action Codes StructureDefinition/us-core-procedure FHIR
145 Procedure Follow up Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
146 Procedure Not Performed Reason (SNOMED-CT) StructureDefinition/us-core-procedure FHIR
147 Procedure Outcome Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
148 Procedure Performer Role Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-procedure
FHIR
149 Provenance activity type StructureDefinition/us-core-provenance FHIR
150 Provenance participant type StructureDefinition/us-core-provenance THO
151 ProvenanceEntityRole StructureDefinition/us-core-provenance FHIR
152 PurposeOfUse StructureDefinition/us-core-provenance THO
153 QuantityComparator StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-bmi
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
FHIR
154 Questionnaire Answer Codes StructureDefinition/us-core-questionnaireresponse FHIR
155 QuestionnaireResponseStatus StructureDefinition/us-core-questionnaireresponse FHIR
156 Race Categories StructureDefinition/us-core-race VSAC
157 Request priority StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-servicerequest
FHIR
158 RequestIntent StructureDefinition/us-core-servicerequest FHIR
159 RequestStatus StructureDefinition/us-core-careplan
StructureDefinition/us-core-servicerequest
FHIR
160 ResourceType StructureDefinition/us-core-provenance
StructureDefinition/us-core-questionnaireresponse
FHIR
161 Route of Administration of Therapeutic Agents StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
VSAC
162 SNOMED CT Additional Dosage Instructions StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
163 SNOMED CT Administration Method Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
164 SNOMED CT Anatomical Structure for Administration Site Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
165 SNOMED CT Body Structures StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-specimen
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-observation-pregnancyintent
StructureDefinition/us-core-procedure
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-servicerequest
StructureDefinition/us-core-simple-observation
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-condition-encounter-diagnosis
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-blood-pressure
FHIR
166 SNOMED CT Clinical Findings StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-careteam
StructureDefinition/us-core-goal
StructureDefinition/us-core-careplan
StructureDefinition/us-core-allergyintolerance
StructureDefinition/us-core-familymemberhistory
FHIR
167 SNOMED CT Form Codes StructureDefinition/us-core-medication FHIR
168 SNOMED CT Medication As Needed Reason Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-servicerequest
FHIR
169 SNOMED CT Medication Codes StructureDefinition/us-core-careplan FHIR
170 SNOMED CT Route Codes StructureDefinition/us-core-allergyintolerance FHIR
171 Screening and Assessment Survey Codes StructureDefinition/us-core-observation-screening-assessment VSAC
172 SecurityLabels StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-documentreference
StructureDefinition/us-core-encounter
StructureDefinition/us-core-observation-lab
FHIR
173 SecurityRoleType StructureDefinition/us-core-provenance FHIR
174 Service Request Category Codes ValueSet/us-core-servicerequest-category
StructureDefinition/us-core-servicerequest
FHIR
175 Service Request Order Details Codes StructureDefinition/us-core-servicerequest FHIR
176 Service type StructureDefinition/us-core-encounter FHIR
177 ServiceDeliveryLocationRoleType ValueSet/us-core-location-type
StructureDefinition/us-core-servicerequest
THO
178 Sex StructureDefinition/us-core-sex VSAC
179 Sexual Orientation Including nulls and Data Absent Reason StructureDefinition/us-core-observation-sexual-orientation VSAC
180 Smoking Status Type StructureDefinition/us-core-smokingstatus VSAC
181 Smoking status comprehensive StructureDefinition/us-core-smokingstatus VSAC
182 Special arrangements StructureDefinition/us-core-encounter FHIR
183 Special courtesy StructureDefinition/us-core-encounter FHIR
184 Specimen Condition SCT ValueSet/us-core-specimen-condition VSAC
185 Specimen Container Type StructureDefinition/us-core-specimen FHIR
186 Specimen processing procedure StructureDefinition/us-core-specimen FHIR
187 Specimen type StructureDefinition/us-core-specimen VSAC
188 SpecimenStatus StructureDefinition/us-core-specimen FHIR
189 SubscriberPolicyholder Relationship Codes StructureDefinition/us-core-coverage FHIR
190 Substance Code StructureDefinition/us-core-allergyintolerance FHIR
191 SubstanceAdminSubstitutionReason StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
THO
192 TribalEntityUS StructureDefinition/us-core-tribal-affiliation THO
193 UDIEntryType StructureDefinition/us-core-device FHIR
194 US Core Clinical Note Type US CORE
195 US Core Clinical Result Observation Category StructureDefinition/us-core-observation-lab
StructureDefinition/us-core-observation-clinical-result
US CORE
196 US Core Condition Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-procedure
StructureDefinition/us-core-servicerequest
StructureDefinition/us-core-condition-encounter-diagnosis
StructureDefinition/us-core-familymemberhistory
US CORE
197 US Core Diagnostic Report Category Codes StructureDefinition/us-core-diagnosticreport-note US CORE
198 US Core DocumentReference Category StructureDefinition/us-core-documentreference US CORE
199 US Core DocumentReference Type StructureDefinition/us-core-documentreference US CORE
200 US Core Goal Codes StructureDefinition/us-core-goal US CORE
201 US Core Laboratory Test Codes StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-observation-lab
US CORE
202 US Core Location Type Codes StructureDefinition/us-core-location US CORE
203 US Core Narrative Status StructureDefinition/us-core-careplan US CORE
204 US Core Non Laboratory Codes StructureDefinition/us-core-diagnosticreport-note US CORE
205 US Core Practitioner Role Specialty Codes StructureDefinition/us-core-practitionerrole US CORE
206 US Core Problem or Health Concern StructureDefinition/us-core-condition-problems-health-concerns US CORE
207 US Core Procedure Codes StructureDefinition/us-core-procedure
StructureDefinition/us-core-servicerequest
US CORE
208 US Core Screening Assessment Condition Category US CORE
209 US Core Screening Assessment Observation Category StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-observation-screening-assessment
US CORE
210 US Core Screening Assessment Observation Maximum Category StructureDefinition/us-core-observation-screening-assessment US CORE
211 US Core ServiceRequest Category Codes StructureDefinition/us-core-servicerequest US CORE
212 US Core Simple Observation Category StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-simple-observation
US CORE
213 US Core Specimen Condition StructureDefinition/us-core-specimen US CORE
214 US Core Status for Smoking Status Observation StructureDefinition/us-core-smokingstatus US CORE
215 USEncounterDischargeDisposition StructureDefinition/us-core-encounter THO
216 USPS Two Letter Alphabetic Codes StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-location
StructureDefinition/us-core-jurisdiction
StructureDefinition/us-core-organization
THO
217 UnitsOfMeasureCaseSensitive StructureDefinition/us-core-smokingstatus THO
218 Vital Sign Result Type StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-bmi
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
VSAC
219 Vital Signs Units StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/us-core-bmi
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-vital-signs
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
FHIR
220 hl7VS-additivePreservative StructureDefinition/us-core-specimen THO
221 hl7VS-bedStatus StructureDefinition/us-core-location THO
222 hl7VS-re-admissionIndicator StructureDefinition/us-core-encounter THO
223 hl7VS-relevantClincialInformation StructureDefinition/us-core-specimen THO
224 hl7VS-specimenCondition ValueSet/us-core-specimen-condition THO
225 v2 table 0360 FHIR Value set/code system definition for HL7 v2 table 0360 ver 2.9 ( Degree/License/Certificate) THO
226 v3 Code System ActCode StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
THO

Code Systems

See the FHIR terminology section for a complete discussion on code systems and a list of code system names used in FHIR. Most code systems used in this guide are defined in the base FHIR specification or HL7 Terminology (THO). However, the following code systems are unique to this guide and not listed in the base FHIR specification. If a URI is listed here, it SHALL be used in the US Core profiles to identify the code system in preference to any other code system URI.

US Core Defined Code Systems

Code System Used in US Core

The following table lists all the CodeSystems used in US Core and where they can be found. This information is also available as a csv or excel file.

Code System Sources:

Row # Code System Code System URI Value Sets Where Used Source
1 AHA NUBC Patient Discharge Status Codes https://www.nubc.org/CodeSystem/PatDischargeStatus ValueSet/v3-USEncounterDischargeDisposition Other
2 ActCode http://terminology.hl7.org/CodeSystem/v3-ActCode ValueSet/v3-ActPharmacySupplyType
ValueSet/v3-ActCode
ValueSet/provenance-activity-type
ValueSet/v3-ActEncounterCode
THO
3 ActPriority http://terminology.hl7.org/CodeSystem/v3-ActPriority ValueSet/v3-ActPriority THO
4 ActReason http://terminology.hl7.org/CodeSystem/v3-ActReason ValueSet/immunization-status-reason
ValueSet/v3-PurposeOfUse
ValueSet/v3-SubstanceAdminSubstitutionReason
THO
5 ActSite http://terminology.hl7.org/CodeSystem/v3-ActSite ValueSet/immunization-site THO
6 AddressType http://hl7.org/fhir/address-type ValueSet/address-type FHIR
7 AddressUse http://hl7.org/fhir/address-use ValueSet/address-use FHIR
8 AdministrativeGender http://hl7.org/fhir/administrative-gender ValueSet/administrative-gender FHIR
9 Admit source http://terminology.hl7.org/CodeSystem/admit-source ValueSet/encounter-admit-source THO
10 Allergy Intolerance Category http://hl7.org/fhir/allergy-intolerance-category ValueSet/allergy-intolerance-category FHIR
11 Allergy Intolerance Criticality http://hl7.org/fhir/allergy-intolerance-criticality ValueSet/allergy-intolerance-criticality FHIR
12 Allergy Intolerance Severity http://hl7.org/fhir/reaction-event-severity ValueSet/reaction-event-severity FHIR
13 Allergy Intolerance Type http://hl7.org/fhir/allergy-intolerance-type ValueSet/allergy-intolerance-type FHIR
14 AllergyIntolerance Clinical Status Codes http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical ValueSet/allergyintolerance-clinical THO
15 AllergyIntolerance Verification Status http://terminology.hl7.org/CodeSystem/allergyintolerance-verification ValueSet/allergyintolerance-verification THO
16 Care Team Status http://hl7.org/fhir/care-team-status ValueSet/care-team-status FHIR
17 CarePlanActivityStatus http://hl7.org/fhir/care-plan-activity-status ValueSet/care-plan-activity-status FHIR
18 Code on Dental Procedures and Nomenclature http://www.ada.org/cdt ValueSet/us-core-procedure-code Other
19 Common Tags http://terminology.hl7.org/CodeSystem/common-tags ValueSet/common-tags THO
20 Composition Status http://hl7.org/fhir/composition-status ValueSet/composition-status FHIR
21 Condition Category Codes http://terminology.hl7.org/CodeSystem/condition-category ValueSet/condition-category
ValueSet/us-core-problem-or-health-concern
THO
22 Condition Clinical Status Codes http://terminology.hl7.org/CodeSystem/condition-clinical ValueSet/condition-clinical THO
23 ConditionVerificationStatus http://terminology.hl7.org/CodeSystem/condition-ver-status ValueSet/condition-ver-status THO
24 Contact entity type http://terminology.hl7.org/CodeSystem/contactentity-type ValueSet/contactentity-type THO
25 ContactPointSystem http://hl7.org/fhir/contact-point-system ValueSet/contact-point-system FHIR
26 ContactPointUse http://hl7.org/fhir/contact-point-use ValueSet/contact-point-use FHIR
27 Contract Signer Type Codes http://terminology.hl7.org/CodeSystem/contractsignertypecodes ValueSet/security-role-type THO
28 Coverage Class Codes http://terminology.hl7.org/CodeSystem/coverage-class ValueSet/coverage-class THO
29 Coverage Copay Type Codes http://terminology.hl7.org/CodeSystem/coverage-copay-type ValueSet/coverage-copay-type THO
30 Current Procedural Terminology (CPT®) http://www.ama-assn.org/go/cpt ValueSet/us-core-procedure-code Other
31 DICOM Controlled Terminology http://dicom.nema.org/resources/ontology/DCM ValueSet/security-role-type Other
32 DataAbsentReason http://terminology.hl7.org/CodeSystem/data-absent-reason ValueSet/data-absent-reason THO
33 DataOperation http://terminology.hl7.org/CodeSystem/v3-DataOperation ValueSet/provenance-activity-type THO
34 Days Of Week http://hl7.org/fhir/days-of-week ValueSet/days-of-week FHIR
35 Device Name Type http://hl7.org/fhir/device-nametype ValueSet/device-nametype FHIR
36 Diagnosis Role http://terminology.hl7.org/CodeSystem/diagnosis-role ValueSet/diagnosis-role THO
37 Diagnostic Report Status http://hl7.org/fhir/diagnostic-report-status ValueSet/diagnostic-report-status FHIR
38 Diet http://terminology.hl7.org/CodeSystem/diet ValueSet/encounter-diet THO
39 Document Relationship Type http://hl7.org/fhir/document-relationship-type ValueSet/document-relationship-type FHIR
40 DocumentCompletion http://terminology.hl7.org/CodeSystem/v3-DocumentCompletion ValueSet/provenance-activity-type THO
41 DocumentReferenceStatus http://hl7.org/fhir/document-reference-status ValueSet/document-reference-status FHIR
42 DoseAndRateType http://terminology.hl7.org/CodeSystem/dose-rate-type ValueSet/dose-rate-type THO
43 Encounter Location Status http://hl7.org/fhir/encounter-location-status ValueSet/encounter-location-status FHIR
44 Encounter Status http://hl7.org/fhir/encounter-status ValueSet/encounter-status FHIR
45 EncounterSpecialCourtesy http://terminology.hl7.org/CodeSystem/v3-EncounterSpecialCourtesy ValueSet/encounter-special-courtesy THO
46 EventStatus http://hl7.org/fhir/event-status ValueSet/immunization-status
ValueSet/event-status
FHIR
47 Example Coverage Financial Exception Codes http://terminology.hl7.org/CodeSystem/ex-coverage-financial-exception ValueSet/coverage-financial-exception THO
48 FHIR Device Status http://hl7.org/fhir/device-status ValueSet/device-status FHIR
49 FHIRDeviceStatusReason http://terminology.hl7.org/CodeSystem/device-status-reason ValueSet/device-status-reason THO
50 Family History Status http://hl7.org/fhir/history-status ValueSet/history-status FHIR
51 FamilyHistoryAbsentReason http://terminology.hl7.org/CodeSystem/history-absent-reason ValueSet/history-absent-reason THO
52 Financial Resource Status Codes http://hl7.org/fhir/fm-status ValueSet/fm-status FHIR
53 Goal Lifecycle Status http://hl7.org/fhir/goal-status ValueSet/goal-status FHIR
54 Goal achievement status http://terminology.hl7.org/CodeSystem/goal-achievement ValueSet/goal-achievement THO
55 Goal category http://terminology.hl7.org/CodeSystem/goal-category ValueSet/goal-category THO
56 Goal priority http://terminology.hl7.org/CodeSystem/goal-priority ValueSet/goal-priority THO
57 HL7 Document Format Codes http://terminology.hl7.org/CodeSystem/v3-HL7DocumentFormatCodes ValueSet/v3-HL7FormatCodes THO
58 Healthcare Common Procedure Coding System (HCPCS) level II alphanumeric codes http://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets ValueSet/us-core-procedure-code Other
59 ICD-10 Procedure Codes http://www.cms.gov/Medicare/Coding/ICD10 ValueSet/us-core-procedure-code Other
60 ICD-9-CM (procedure codes) http://hl7.org/fhir/sid/icd-9-cm ValueSet/us-core-condition-code CDC
61 IHE Format Code set for use with Document Sharing http://ihe.net/fhir/ihe.formatcode.fhir/CodeSystem/formatcode ValueSet/v3-HL7FormatCodes Other
62 IdentifierUse http://hl7.org/fhir/identifier-use ValueSet/identifier-use FHIR
63 Immunization Funding Source http://terminology.hl7.org/CodeSystem/immunization-funding-source ValueSet/immunization-funding-source THO
64 Immunization Origin Codes http://terminology.hl7.org/CodeSystem/immunization-origin ValueSet/immunization-origin THO
65 Immunization Program Eligibility http://terminology.hl7.org/CodeSystem/immunization-program-eligibility ValueSet/immunization-program-eligibility THO
66 Immunization Subpotent Reason http://terminology.hl7.org/CodeSystem/immunization-subpotent-reason ValueSet/immunization-subpotent-reason THO
67 International Classification of Diseases http://hl7.org/fhir/sid/icd-10-cm Clinical Modification (ICD-10-CM) CDC
68 Link Type http://hl7.org/fhir/link-type ValueSet/link-type FHIR
69 Location Mode http://hl7.org/fhir/location-mode ValueSet/location-mode FHIR
70 Location Status http://hl7.org/fhir/location-status ValueSet/location-status FHIR
71 Location type http://terminology.hl7.org/CodeSystem/location-physical-type ValueSet/location-physical-type THO
72 Logical Observation Identifiers http://loinc.org LOINC provides a set of universal names and ID codes for identifying laboratory and clinical test results.1
2 LOINC facilitates the exchange and pooling of results
such as blood hemoglobin
serum potassium
or vital signs
for clinical care
outcomes management
and research. LOINC's universal identifiers (names and codes) can be used in the context of order and observation exchanges between information systems that use syntax standards such as HL73
CEN TC251
ISO TC215
ASTM4
and DICOM. Specifically
the identifier can be used as the coded value for an observation in any other standard that uses the observation/observation value paradigm
whether messages
documents
application programming interface (API)
etc. For example
LOINC codes are used widely in the OBX segment Observation Identifier field (OBX-3) of an ORU HL7 (HL7 version 2.x or ASTM 1238-9410) message that may be sent between a Clinical Laboratory Information Management Systems (LIMS) and Electronic Health Record Systems (EHR).5
6 In this way
LOINC codes provide universal identifiers that allow the exchange of clinical data between heterogeneous computing environments.
LOINC
73 MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus ValueSet/marital-status THO
74 Medication Status Codes http://hl7.org/fhir/CodeSystem/medication-status ValueSet/medication-status FHIR
75 Medication dispense category codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category ValueSet/medicationdispense-category THO
76 Medication dispense status codes http://terminology.hl7.org/CodeSystem/medicationdispense-status ValueSet/medicationdispense-status THO
77 Medication dispense status reason codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-status-reason ValueSet/medicationdispense-status-reason THO
78 MedicationDispense Performer Function Codes http://terminology.hl7.org/CodeSystem/medicationdispense-performer-function ValueSet/medicationdispense-performer-function THO
79 MedicationRequest Category Codes http://terminology.hl7.org/CodeSystem/medicationrequest-category ValueSet/medicationrequest-category THO
80 MedicationRequest Course of Therapy Codes http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy ValueSet/medicationrequest-course-of-therapy THO
81 MedicationRequest Intent Codes http://hl7.org/fhir/CodeSystem/medicationrequest-intent ValueSet/medicationrequest-intent FHIR
82 MedicationRequest Status Codes http://hl7.org/fhir/CodeSystem/medicationrequest-status ValueSet/medicationrequest-status FHIR
83 MedicationRequest Status Reason Codes http://terminology.hl7.org/CodeSystem/medicationrequest-status-reason ValueSet/medicationrequest-status-reason THO
84 NameUse http://hl7.org/fhir/name-use ValueSet/name-use FHIR
85 NarrativeStatus http://hl7.org/fhir/narrative-status ValueSet/us-core-narrative-status FHIR
86 NullFlavor http://terminology.hl7.org/CodeSystem/v3-NullFlavor ValueSet/us-core-documentreference-type
ValueSet/marital-status
ValueSet/encounter-special-courtesy
THO
87 Observation Category Codes http://terminology.hl7.org/CodeSystem/observation-category ValueSet/us-core-screening-assessment-observation-category
ValueSet/us-core-simple-observation-category
ValueSet/us-core-clinical-result-observation-category
ValueSet/observation-category
ValueSet/us-core-screening-assessment-observation-maximum-category
THO
88 Observation Reference Range Meaning Codes http://terminology.hl7.org/CodeSystem/referencerange-meaning ValueSet/referencerange-meaning THO
89 Observation Status http://hl7.org/fhir/observation-status ValueSet/us-core-observation-smoking-status-status
ValueSet/observation-status
FHIR
90 ObservationInterpretation http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation ValueSet/observation-interpretation THO
91 Occupational Data for Health (ODH) http://terminology.hl7.org/CodeSystem/PHOccupationalDataForHealthODH ValueSet/2.16.840.1.114222.4.11.7900
ValueSet/2.16.840.1.114222.4.11.7901
THO
92 Organization type http://terminology.hl7.org/CodeSystem/organization-type ValueSet/organization-type THO
93 Participant type http://terminology.hl7.org/CodeSystem/participant-type ValueSet/encounter-participant-type THO
94 ParticipationFunction http://terminology.hl7.org/CodeSystem/v3-ParticipationFunction ValueSet/security-role-type THO
95 ParticipationType http://terminology.hl7.org/CodeSystem/v3-ParticipationType ValueSet/security-role-type
ValueSet/encounter-participant-type
ValueSet/provenance-activity-type
THO
96 Provenance Entity Role http://hl7.org/fhir/provenance-entity-role ValueSet/provenance-entity-role FHIR
97 Provenance participant type http://terminology.hl7.org/CodeSystem/provenance-participant-type ValueSet/provenance-agent-type THO
98 QuantityComparator http://hl7.org/fhir/quantity-comparator ValueSet/quantity-comparator FHIR
99 Questionnaire Response Status http://hl7.org/fhir/questionnaire-answers-status ValueSet/questionnaire-answers-status FHIR
100 RequestIntent http://hl7.org/fhir/request-intent ValueSet/request-intent
ValueSet/care-plan-intent
FHIR
101 RequestPriority http://hl7.org/fhir/request-priority ValueSet/request-priority FHIR
102 RequestStatus http://hl7.org/fhir/request-status ValueSet/request-status FHIR
103 ResourceType http://hl7.org/fhir/resource-types ValueSet/resource-types
ValueSet/care-plan-activity-kind
FHIR
104 RoleClass http://terminology.hl7.org/CodeSystem/v3-RoleClass ValueSet/security-role-type THO
105 RoleCode http://terminology.hl7.org/CodeSystem/v3-RoleCode ValueSet/security-role-type
ValueSet/2.16.840.1.113883.11.20.12.1-20251204
ValueSet/v3-ServiceDeliveryLocationRoleType
ValueSet/2.16.840.1.113883.1.11.19579-20250724
THO
106 RouteOfAdministration http://terminology.hl7.org/CodeSystem/v3-RouteOfAdministration ValueSet/immunization-route THO
107 SNOMED CT (all versions) http://snomed.info/sct ValueSet/servicerequest-category
ValueSet/specimen-container-type
ValueSet/procedure-followup
ValueSet/us-core-goal-description
ValueSet/specimen-collection-method
ValueSet/medication-form-codes
ValueSet/body-site
ValueSet/manifestation-or-symptom
ValueSet/procedure-code
ValueSet/goal-start-event
ValueSet/medication-as-needed-reason
ValueSet/c80-facilitycodes
ValueSet/immunization-reason
ValueSet/substance-code
ValueSet/2.16.840.1.113762.1.4.1099.54-20240606
ValueSet/observation-methods
ValueSet/us-core-procedure-code
ValueSet/care-plan-category
ValueSet/questionnaire-answers
ValueSet/servicerequest-orderdetail
ValueSet/2.16.840.1.113762.1.4.1166.22-20230802
ValueSet/clinical-findings
ValueSet/condition-stage
ValueSet/encounter-reason
ValueSet/immunization-target-disease
ValueSet/participant-role
ValueSet/additional-instruction-codes
ValueSet/approach-site-codes
ValueSet/device-action
ValueSet/us-core-condition-code
ValueSet/medication-codes
ValueSet/device-kind
ValueSet/performer-role
ValueSet/us-core-servicerequest-category
ValueSet/referencerange-appliesto
ValueSet/c80-practice-codes
ValueSet/2.16.840.1.113762.1.4.1267.3-20240217
ValueSet/route-codes
ValueSet/care-plan-activity-outcome
ValueSet/2.16.840.1.113762.1.4.1021.121-20250228
ValueSet/procedure-outcome
ValueSet/procedure-category
ValueSet/condition-code
ValueSet/condition-stage-type
ValueSet/procedure-not-performed-reason
ValueSet/immunization-status-reason
ValueSet/condition-outcome
ValueSet/administration-method-codes
ValueSet/condition-severity
SNOMED
108 Security Role Type http://terminology.hl7.org/CodeSystem/extra-security-role-type ValueSet/security-role-type THO
109 Service type http://terminology.hl7.org/CodeSystem/service-type ValueSet/service-type THO
110 Source of Payment Typology https://nahdo.org/sopt ValueSet/2.16.840.1.114222.4.11.3591-20250419 CDC
111 Special arrangements http://terminology.hl7.org/CodeSystem/encounter-special-arrangements ValueSet/encounter-special-arrangements THO
112 Specimen Status http://hl7.org/fhir/specimen-status ValueSet/specimen-status FHIR
113 SubscriberPolicyholder Relationship Codes http://terminology.hl7.org/CodeSystem/subscriber-relationship ValueSet/subscriber-relationship THO
114 Substance Admin Substitution http://terminology.hl7.org/CodeSystem/v3-substanceAdminSubstitution ValueSet/v3-ActSubstanceAdminSubstitutionCode THO
115 Tags for the Identification of Languages urn:ietf:bcp:47 ValueSet/languages
ValueSet/Languages
Other
116 TribalEntityUS http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS ValueSet/v3-TribalEntityUS THO
117 UDI Entry Type http://hl7.org/fhir/udi-entry-type ValueSet/udi-entry-type FHIR
118 US Core Category http://hl7.org/fhir/us/core/CodeSystem/us-core-category ValueSet/us-core-screening-assessment-observation-category
ValueSet/us-core-simple-observation-category
ValueSet/us-core-servicerequest-category
ValueSet/us-core-screening-assessment-condition-category
ValueSet/us-core-screening-assessment-observation-maximum-category
US CORE
119 US Core Condition Category Extension Codes http://hl7.org/fhir/us/core/CodeSystem/condition-category ValueSet/us-core-problem-or-health-concern US CORE
120 US Core DocumentReferences Category Codes http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category ValueSet/us-core-documentreference-category US CORE
121 USPS State Codes https://www.usps.com/ ValueSet/USPS-State Other
122 Unified Code for Units of Measure (UCUM) http://unitsofmeasure.org ValueSet/ucum-bodyweight
ValueSet/ucum-bodytemp
ValueSet/ucum-common
ValueSet/ucum-vitals-common
ValueSet/ucum-bodylength
ValueSet/v3-UnitsOfMeasureCaseSensitive
UCUM
123 Vaccine Administered Code Set (CVX) http://hl7.org/fhir/sid/cvx ValueSet/2.16.840.1.113762.1.4.1010.6-20250411 CDC
124 additivePreservative http://terminology.hl7.org/CodeSystem/v2-0371 ValueSet/v2-0371 THO
125 bedStatus http://terminology.hl7.org/CodeSystem/v2-0116 ValueSet/v2-0116 THO
126 contactRole2 http://terminology.hl7.org/CodeSystem/v2-0131 ValueSet/patient-contactrelationship THO
127 diagnosticServiceSectionId http://terminology.hl7.org/CodeSystem/v2-0074 ValueSet/diagnostic-service-sections THO
128 identifierType http://terminology.hl7.org/CodeSystem/v2-0203 ValueSet/identifier-type THO
129 providerRole http://terminology.hl7.org/CodeSystem/v2-0443 ValueSet/immunization-function THO
130 re-admissionIndicator http://terminology.hl7.org/CodeSystem/v2-0092 ValueSet/v2-0092 THO
131 relevantClincialInformation http://terminology.hl7.org/CodeSystem/v2-0916 ValueSet/v2-0916 THO
132 treatment http://terminology.hl7.org/CodeSystem/v2-0373 ValueSet/specimen-processing-procedure THO

The Value Set Authority Center (VSAC)

This guide links terminology directly to the FHIR® Terminology Service for VSAC Resources (Value Set Authority Center (VSAC)), where applicable, using a RESTful API service to access the VSAC value sets and supported code systems. See the table above for a list of value sets used in US Core that VSAC defines.

How to Acess Value Sets in VSAC

  • VSAC requires login using your own UMLS API Key to view the value sets. VSAC UMLS Licensing information. (See the screenshots below)
  • The value sets in VSAC are specified using a VSAC value set OID.
  • To view the value set expansion in the VSAC user interface, use:

    GET https://vsac.nlm.nih.gov/ValueSet/[VSAC OID]/expansion

    An example of this is shown in the screenshots below.

    When viewing a ValueSet in the VSAC UI, the Code System OIDs and VSAC Code System names are displayed for each code. However, these code system identifiers SHOULD NOT be used. The FHIR URIs code systems are defined as part of FHIR and SHOULD be used instead. Unfortunately, the FHIR URI for the code system is not shown. As a convenience for the reader, a VSAC to FHIR Code System Mapping Table is provided, which maps the VSAC Code System names to the corresponding FHIR URI. For more information, see this documentation describing the relationships between the VSAC value set name, FHIR value set name, and FHIR value set title and how to access VSAC's FHIR API.

  • To fetch the FHIR ValueSet resource (in other words, the value set definition), use:

    GET https://cts.nlm.nih.gov/fhir/ValueSet/[VSAC OID]

  • To fetch the FHIR ValueSet resource expansion, use the FHIR $expand operation:

    GET https://cts.nlm.nih.gov/fhir/ValueSet/[VSAC OID]/$expand

For more information, refer to the FHIR Terminology Service for VSAC Resources

Example

For example, the US Core Smoking Status Observation Profile valueCodeableConcept element has a preferred binding to the Smoking Status value set. To access it in VSAC, click on the link to https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.11.20.9.38/expansion:

Figure 1: VSAC link
vsac-1.png

The reader is redirected to the VSAC login page to enter an API Key (only one login is required per session):

Figure 2: VSAC API-Key Login
vsac-2.png

After successfully entering the API Key, the value set can be inspected, downloaded, etc., using the VSAC User interface, as shown in the figure below. This FHIR ValueSet resource can also be fetched using the URL https://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.11.20.9.38, and the FHIR ValueSet expansion using the URL https://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.11.20.9.38/$expand.

Figure 3: VSAC Smoking Status ValueSet
vsac-3.png