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

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

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. This snapshot of these versions can be viewed in the Expansion Parameters resource. However, US Core does not require a specific version of terminology to be used with a specific version of US Core. 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 more recent version of US Core's valueset. This flexibility better reflects real-world use 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

In addition to the terminology published with each version of US Core, the link below provides annual value set package updates for US Core Versions 6.1.0, 8.0.1, and 9.0.0 to assist implementers who require them. These packages contain all the expanded value sets required for an implementation guide, and are based on the current code system and value set versions.

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 AcquisitionModality StructureDefinition/us-core-imagingstudy Other
2 Common UCUM units StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-medicationadministration
FHIR
3 ActEncounterCode StructureDefinition/us-core-encounter THO
4 ActNoImmunizationReason StructureDefinition/us-core-immunization THO
5 ActPharmacySupplyType StructureDefinition/us-core-medicationdispense THO
6 ActPriority StructureDefinition/us-core-encounter THO
7 ActSubstanceAdminSubstitutionCode StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
THO
8 AddressType StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-location
StructureDefinition/us-core-organization
FHIR
9 AddressUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-location
StructureDefinition/us-core-organization
FHIR
10 AdministrativeGender StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-familymemberhistory
StructureDefinition/us-core-relatedperson
FHIR
11 Admit source StructureDefinition/us-core-encounter FHIR
12 Advance Healthcare Directive Categories LOINC StructureDefinition/us-core-adi-documentreference VSAC
13 Advance Healthcare Directive Document Types Grouper StructureDefinition/us-core-adi-documentreference VSAC
14 Allergen Concepts (Medications and Environmental Substances) including refutations. VSAC
15 AllergyIntolerance Clinical Status Codes StructureDefinition/us-core-allergyintolerance FHIR
16 AllergyIntolerance Verification Status Codes StructureDefinition/us-core-allergyintolerance FHIR
17 AllergyIntoleranceCategory StructureDefinition/us-core-allergyintolerance FHIR
18 AllergyIntoleranceCriticality StructureDefinition/us-core-allergyintolerance FHIR
19 AllergyIntoleranceSeverity StructureDefinition/us-core-allergyintolerance FHIR
20 AllergyIntoleranceType StructureDefinition/us-core-allergyintolerance FHIR
21 Answer Set with Yes No and Unknowns StructureDefinition/us-core-interpreter-needed
StructureDefinition/us-core-observation-adi-documentation
VSAC
22 Appointment cancellation reason StructureDefinition/us-core-appointment FHIR
23 AppointmentStatus StructureDefinition/us-core-appointment FHIR
24 Birth Sex StructureDefinition/us-core-birthsex VSAC
25 Body Length Units StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-height
FHIR
26 Body Temperature Units StructureDefinition/us-core-body-temperature FHIR
27 Body Weight Units StructureDefinition/us-core-body-weight FHIR
28 CMS Place of Service Codes (POS) ValueSet/us-core-location-type THO
29 CVX Vaccines Administered Vaccine Set StructureDefinition/us-core-immunization VSAC
30 Care Plan Activity Kind StructureDefinition/us-core-careplan FHIR
31 Care Plan Activity Outcome StructureDefinition/us-core-careplan FHIR
32 Care Plan Category StructureDefinition/us-core-careplan FHIR
33 Care Plan Intent StructureDefinition/us-core-careplan FHIR
34 Care Team Member Function StructureDefinition/us-core-practitionerrole VSAC
35 Care Team category StructureDefinition/us-core-careteam FHIR
36 CarePlanActivityStatus StructureDefinition/us-core-careplan FHIR
37 CareTeamStatus StructureDefinition/us-core-careteam FHIR
38 Clinical Goals StructureDefinition/us-core-goal VSAC
39 Codes for Immunization Site of Administration StructureDefinition/us-core-immunization FHIR
40 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-practitioner
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-appointment
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-patient
StructureDefinition/us-core-nutritionorder
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-provenance
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-questionnaireresponse
StructureDefinition/us-core-condition-encounter-diagnosis
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
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-imagingstudy
StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-medication
StructureDefinition/us-core-goal
StructureDefinition/us-core-careteam
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-immunization
StructureDefinition/us-core-familymemberhistory
StructureDefinition/us-core-relatedperson
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-location
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-medicationadministration
StructureDefinition/us-core-allergyintolerance
StructureDefinition/us-core-blood-pressure
FHIR
41 Common Tags StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-encounter
StructureDefinition/us-core-observation-lab
FHIR
42 CompositionStatus StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
43 Condition Category Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
44 Condition Clinical Status Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
45 Condition Outcome Codes StructureDefinition/us-core-familymemberhistory FHIR
46 Condition Stage StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
47 Condition Stage Type StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
48 Condition/Diagnosis Severity StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
49 Condition/Problem/Diagnosis Codes StructureDefinition/us-core-procedure
StructureDefinition/us-core-devicerequest
FHIR
50 ConditionVerificationStatus StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
51 Contact entity type StructureDefinition/us-core-organization FHIR
52 ContactPointSystem StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-organization
FHIR
53 ContactPointUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-organization
FHIR
54 Coverage Class Codes StructureDefinition/us-core-coverage FHIR
55 Coverage Copay Type Codes StructureDefinition/us-core-coverage FHIR
56 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-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
57 DaysOfWeek StructureDefinition/us-core-practitionerrole
StructureDefinition/us-core-location
FHIR
58 Detailed Ethnicity Including Absence Reasons StructureDefinition/us-core-ethnicity VSAC
59 Detailed race including absence reasons. StructureDefinition/us-core-race VSAC
60 DeviceNameType StructureDefinition/us-core-device FHIR
61 DiagnosisRole StructureDefinition/us-core-encounter FHIR
62 Diagnostic Service Section Codes StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
FHIR
63 DiagnosticReportStatus StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
FHIR
64 Diet StructureDefinition/us-core-nutritionorder
StructureDefinition/us-core-encounter
FHIR
65 Diet Codes StructureDefinition/us-core-nutritionorder FHIR
66 Document Class Value Set StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
67 Document Type Value Set OperationDefinition/docref FHIR
68 DocumentReferenceStatus StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
69 DocumentRelationshipType StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
70 DoseAndRateType StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
71 Encounter Reason Codes StructureDefinition/us-core-encounter
StructureDefinition/us-core-appointment
FHIR
72 Encounter Type StructureDefinition/us-core-encounter VSAC
73 EncounterLocationStatus StructureDefinition/us-core-encounter FHIR
74 EncounterStatus StructureDefinition/us-core-encounter FHIR
75 Enteral Formula Additive Type Code StructureDefinition/us-core-nutritionorder FHIR
76 Enteral Formula Type Codes StructureDefinition/us-core-nutritionorder FHIR
77 Enteral Route Codes StructureDefinition/us-core-nutritionorder FHIR
78 Ethnicity Categories StructureDefinition/us-core-ethnicity VSAC
79 EventStatus StructureDefinition/us-core-procedure FHIR
80 Example Coverage Financial Exception Codes StructureDefinition/us-core-coverage FHIR
81 FHIR Device Types StructureDefinition/us-core-procedure
StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-device
FHIR
82 FHIRDeviceStatus StructureDefinition/us-core-device FHIR
83 FHIRDeviceStatusReason StructureDefinition/us-core-device FHIR
84 Facility Type Code Value Set StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
85 Family Member Value StructureDefinition/us-core-familymemberhistory VSAC
86 FamilyHistoryAbsentReason StructureDefinition/us-core-familymemberhistory FHIR
87 FamilyHistoryStatus StructureDefinition/us-core-familymemberhistory FHIR
88 Federal Administrative Sex StructureDefinition/us-core-individual-sex VSAC
89 Financial Resource Status Codes StructureDefinition/us-core-coverage FHIR
90 Fluid Consistency Type Codes StructureDefinition/us-core-nutritionorder FHIR
91 Food Type Codes StructureDefinition/us-core-nutritionorder FHIR
92 Gender Identity StructureDefinition/us-core-genderIdentity VSAC
93 Goal achievement status StructureDefinition/us-core-goal FHIR
94 Goal category StructureDefinition/us-core-goal FHIR
95 Goal priority StructureDefinition/us-core-goal FHIR
96 Goal start event StructureDefinition/us-core-goal FHIR
97 GoalLifecycleStatus StructureDefinition/us-core-goal FHIR
98 HL7 ValueSet of Format Codes for use with Document Sharing StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
THO
99 Healthcare Provider Taxonomy ValueSet/us-core-practitionerrole-specialty VSAC
100 Healthcare Service Location Type Combined ValueSet/us-core-location-type VSAC
101 IdentifierType StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-encounter
StructureDefinition/us-core-coverage
StructureDefinition/us-core-organization
FHIR
102 IdentifierUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
StructureDefinition/us-core-encounter
StructureDefinition/us-core-coverage
StructureDefinition/us-core-organization
FHIR
103 ImagingStudy series performer function StructureDefinition/us-core-imagingstudy FHIR
104 ImagingStudyStatus StructureDefinition/us-core-imagingstudy FHIR
105 Immunization Function Codes StructureDefinition/us-core-immunization FHIR
106 Immunization Funding Source StructureDefinition/us-core-immunization FHIR
107 Immunization Origin Codes StructureDefinition/us-core-immunization FHIR
108 Immunization Program Eligibility StructureDefinition/us-core-immunization FHIR
109 Immunization Reason Codes StructureDefinition/us-core-immunization FHIR
110 Immunization Route Codes StructureDefinition/us-core-immunization FHIR
111 Immunization Status Codes StructureDefinition/us-core-immunization FHIR
112 Immunization Subpotent Reason StructureDefinition/us-core-immunization FHIR
113 Immunization Target Disease Codes StructureDefinition/us-core-immunization FHIR
114 Industry NAICS Detail (ODH) StructureDefinition/us-core-observation-occupation PHINVADS
115 Information Source for Medication Adherence StructureDefinition/us-core-medication-adherence VSAC
116 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-patient-accommodation
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-smokingstatus
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-observation-adi-documentation
FHIR
117 Languages StructureDefinition/us-core-patient THO
118 Laterality StructureDefinition/us-core-imagingstudy FHIR
119 LinkType StructureDefinition/us-core-patient FHIR
120 Location type StructureDefinition/us-core-encounter
StructureDefinition/us-core-location
FHIR
121 LocationMode StructureDefinition/us-core-location FHIR
122 LocationStatus StructureDefinition/us-core-location FHIR
123 Manifestation and Symptom Codes StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-condition-encounter-diagnosis
FHIR
124 MaritalStatus StructureDefinition/us-core-patient FHIR
125 Medication status codes StructureDefinition/us-core-medication FHIR
126 Medication Adherence StructureDefinition/us-core-medication-adherence VSAC
127 Medication Clinical Drug StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medication
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-medicationadministration
VSAC
128 Medication administration category codes StructureDefinition/us-core-medicationadministration FHIR
129 Medication administration performer function codes StructureDefinition/us-core-medicationadministration FHIR
130 Medication administration status codes StructureDefinition/us-core-medicationadministration FHIR
131 Medication dispense category codes StructureDefinition/us-core-medicationdispense FHIR
132 Medication dispense performer function codes StructureDefinition/us-core-medicationdispense FHIR
133 Medication dispense status codes StructureDefinition/us-core-medicationdispense FHIR
134 Medication dispense status reason codes StructureDefinition/us-core-medicationdispense FHIR
135 Medication request category codes StructureDefinition/us-core-medicationrequest FHIR
136 Medication request course of therapy codes StructureDefinition/us-core-medicationrequest FHIR
137 Medication request intent StructureDefinition/us-core-medicationrequest FHIR
138 Medication request status reason codes StructureDefinition/us-core-medicationrequest FHIR
139 Medicationrequest status StructureDefinition/us-core-medicationrequest FHIR
140 MimeType StructureDefinition/us-core-adi-documentreference
StructureDefinition/us-core-documentreference
FHIR
141 NameUse StructureDefinition/us-core-practitioner
StructureDefinition/us-core-patient
FHIR
142 Nutrient Modifier Codes StructureDefinition/us-core-nutritionorder FHIR
143 Observation Category 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-observation-clinical-result
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-vital-signs
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
FHIR
144 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-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
145 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-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
146 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-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
147 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-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
148 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-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
149 Occupation ONETSOC Detail (ODH) StructureDefinition/us-core-observation-occupation PHINVADS
150 Organization type StructureDefinition/us-core-organization FHIR
151 Participant Roles StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-servicerequest
FHIR
152 Participant type StructureDefinition/us-core-encounter
StructureDefinition/us-core-appointment
FHIR
153 ParticipantRequired StructureDefinition/us-core-appointment FHIR
154 ParticipationStatus StructureDefinition/us-core-appointment FHIR
155 Patient Contact Relationship StructureDefinition/us-core-patient FHIR
156 Payer Type StructureDefinition/us-core-coverage VSAC
157 Personal And Legal Relationship Role Type StructureDefinition/us-core-relatedperson VSAC
158 Practice Setting Code Value Set StructureDefinition/us-core-adi-documentreference
ValueSet/us-core-practitionerrole-specialty
StructureDefinition/us-core-documentreference
StructureDefinition/us-core-appointment
FHIR
159 Pregnancy Intention StructureDefinition/us-core-observation-pregnancyintent VSAC
160 Pregnancy Status Observation StructureDefinition/us-core-observation-pregnancystatus VSAC
161 Procedure Category Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
162 Procedure Codes (SNOMED CT) StructureDefinition/us-core-careplan FHIR
163 Procedure Device Action Codes StructureDefinition/us-core-procedure FHIR
164 Procedure Follow up Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
165 Procedure Not Performed Reason (SNOMED-CT) StructureDefinition/us-core-procedure FHIR
166 Procedure Outcome Codes (SNOMED CT) StructureDefinition/us-core-procedure FHIR
167 Procedure Performer Role Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-procedure
FHIR
168 Procedure Reason Codes StructureDefinition/us-core-imagingstudy FHIR
169 Provenance activity type StructureDefinition/us-core-provenance FHIR
170 Provenance participant type StructureDefinition/us-core-provenance FHIR
171 Provenance participant type StructureDefinition/us-core-provenance THO
172 ProvenanceEntityRole StructureDefinition/us-core-provenance FHIR
173 PurposeOfUse StructureDefinition/us-core-provenance THO
174 QuantityComparator StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-body-temperature
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
FHIR
175 Questionnaire Answer Codes StructureDefinition/us-core-questionnaireresponse FHIR
176 QuestionnaireResponseStatus StructureDefinition/us-core-questionnaireresponse FHIR
177 Race Categories StructureDefinition/us-core-race VSAC
178 Reason Medication Given Codes StructureDefinition/us-core-medicationadministration FHIR
179 Request priority StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-servicerequest
FHIR
180 RequestIntent StructureDefinition/us-core-nutritionorder
StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-servicerequest
FHIR
181 RequestStatus StructureDefinition/us-core-nutritionorder
StructureDefinition/us-core-devicerequest
StructureDefinition/us-core-careplan
StructureDefinition/us-core-servicerequest
FHIR
182 ResourceType StructureDefinition/us-core-provenance
StructureDefinition/us-core-questionnaireresponse
FHIR
183 Route of Administration of Therapeutic Agents StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-medicationadministration
VSAC
184 SNOMED CT Additional Dosage Instructions StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
FHIR
185 SNOMED CT Administration Method Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-medicationadministration
FHIR
186 SNOMED CT Anatomical Structure for Administration Site Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-medicationadministration
FHIR
187 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-imagingstudy
StructureDefinition/us-core-smokingstatus
StructureDefinition/us-core-body-height
StructureDefinition/us-core-care-experience-preference
StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-observation-screening-assessment
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-condition-encounter-diagnosis
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-patient-accommodation
StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-observation-pregnancystatus
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-observation-occupation
StructureDefinition/us-core-average-blood-pressure
StructureDefinition/us-core-treatment-intervention-preference
StructureDefinition/us-core-observation-adi-documentation
StructureDefinition/us-core-observation-sexual-orientation
StructureDefinition/us-core-blood-pressure
FHIR
188 SNOMED CT Clinical Findings StructureDefinition/us-core-diagnosticreport-note
StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-goal
StructureDefinition/us-core-careteam
StructureDefinition/us-core-careplan
StructureDefinition/us-core-allergyintolerance
StructureDefinition/us-core-familymemberhistory
FHIR
189 SNOMED CT Form Codes StructureDefinition/us-core-medication FHIR
190 SNOMED CT Medication As Needed Reason Codes StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
StructureDefinition/us-core-servicerequest
FHIR
191 SNOMED CT Medication Codes StructureDefinition/us-core-careplan FHIR
192 SNOMED CT Reason Medication Not Given Codes StructureDefinition/us-core-medicationadministration FHIR
193 SNOMED CT Route Codes StructureDefinition/us-core-allergyintolerance FHIR
194 Screening and Assessment Survey Codes StructureDefinition/us-core-observation-screening-assessment VSAC
195 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
196 SecurityRoleType StructureDefinition/us-core-provenance FHIR
197 Service Request Category Codes ValueSet/us-core-servicerequest-category
StructureDefinition/us-core-servicerequest
FHIR
198 Service Request Order Details Codes StructureDefinition/us-core-servicerequest FHIR
199 Service category StructureDefinition/us-core-appointment FHIR
200 Service type StructureDefinition/us-core-encounter FHIR
201 Service type StructureDefinition/us-core-appointment THO
202 ServiceDeliveryLocationRoleType ValueSet/us-core-location-type
StructureDefinition/us-core-servicerequest
THO
203 Sex StructureDefinition/us-core-sex VSAC
204 Sexual Orientation Including nulls and Data Absent Reason StructureDefinition/us-core-observation-sexual-orientation VSAC
205 Smoking Status Type StructureDefinition/us-core-smokingstatus VSAC
206 Special arrangements StructureDefinition/us-core-encounter FHIR
207 Special courtesy StructureDefinition/us-core-encounter FHIR
208 Specimen Collection Method StructureDefinition/us-core-specimen VSAC
209 Specimen Condition SCT ValueSet/us-core-specimen-condition VSAC
210 Specimen Container Type StructureDefinition/us-core-specimen FHIR
211 Specimen processing procedure StructureDefinition/us-core-specimen FHIR
212 Specimen type StructureDefinition/us-core-specimen VSAC
213 SpecimenStatus StructureDefinition/us-core-specimen FHIR
214 SubscriberPolicyholder Relationship Codes StructureDefinition/us-core-coverage FHIR
215 Substance Code StructureDefinition/us-core-allergyintolerance FHIR
216 SubstanceAdminSubstitutionReason StructureDefinition/us-core-medicationrequest
StructureDefinition/us-core-medicationdispense
THO
217 Supplement Type Codes StructureDefinition/us-core-nutritionorder FHIR
218 Texture Modified Food Type Codes StructureDefinition/us-core-nutritionorder FHIR
219 Texture Modifier Codes StructureDefinition/us-core-nutritionorder FHIR
220 Tobacco And Nicotine Use StructureDefinition/us-core-smokingstatus VSAC
221 TribalEntityUS StructureDefinition/us-core-tribal-affiliation THO
222 UDIEntryType StructureDefinition/us-core-device FHIR
223 US Core Clinical Note Type StructureDefinition/us-core-documentreference US CORE
224 US Core Clinical Result Observation Category StructureDefinition/us-core-observation-clinical-result
StructureDefinition/us-core-observation-lab
US CORE
225 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
226 US Core Diagnostic Report Category Codes StructureDefinition/us-core-diagnosticreport-note US CORE
227 US Core DocumentReference Category StructureDefinition/us-core-documentreference US CORE
228 US Core DocumentReference Type StructureDefinition/us-core-documentreference US CORE
229 US Core Laboratory Test Codes StructureDefinition/us-core-diagnosticreport-lab
StructureDefinition/us-core-observation-lab
US CORE
230 US Core Location Type Codes StructureDefinition/us-core-location US CORE
231 US Core Narrative Status StructureDefinition/us-core-careplan US CORE
232 US Core Non Laboratory Codes StructureDefinition/us-core-diagnosticreport-note US CORE
233 US Core Practitioner Role Specialty Codes StructureDefinition/us-core-practitionerrole US CORE
234 US Core Problem or Health Concern StructureDefinition/us-core-condition-problems-health-concerns US CORE
235 US Core Procedure Codes StructureDefinition/us-core-procedure
StructureDefinition/us-core-servicerequest
US CORE
236 US Core Screening Assessment Condition Category StructureDefinition/us-core-condition-problems-health-concerns US CORE
237 US Core Screening Assessment Observation Category StructureDefinition/us-core-observation-screening-assessment US CORE
238 US Core Screening Assessment Observation Maximum Category StructureDefinition/us-core-observation-screening-assessment US CORE
239 US Core ServiceRequest Category Codes StructureDefinition/us-core-servicerequest US CORE
240 US Core Simple Observation Category StructureDefinition/us-core-condition-problems-health-concerns
StructureDefinition/us-core-patient-accommodation
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
241 US Core Specimen Condition StructureDefinition/us-core-specimen US CORE
242 US Core Tobacco And Nicotine Observation Status StructureDefinition/us-core-smokingstatus US CORE
243 USEncounterDischargeDisposition StructureDefinition/us-core-encounter THO
244 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
245 UnitsOfMeasureCaseSensitive StructureDefinition/us-core-smokingstatus THO
246 Vital Sign Result Type StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-vital-signs
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
VSAC
247 Vital Signs Units StructureDefinition/pediatric-bmi-for-age
StructureDefinition/us-core-pulse-oximetry
StructureDefinition/head-occipital-frontal-circumference-percentile
StructureDefinition/us-core-bmi
StructureDefinition/us-core-respiratory-rate
StructureDefinition/us-core-body-temperature
StructureDefinition/us-core-vital-signs
StructureDefinition/pediatric-weight-for-height
StructureDefinition/us-core-heart-rate
StructureDefinition/us-core-head-circumference
StructureDefinition/us-core-body-weight
StructureDefinition/us-core-body-height
StructureDefinition/us-core-blood-pressure
FHIR
248 hl7VS-additivePreservative StructureDefinition/us-core-specimen THO
249 hl7VS-appointmentReasonCodes StructureDefinition/us-core-appointment THO
250 hl7VS-bedStatus StructureDefinition/us-core-location THO
251 hl7VS-re-admissionIndicator StructureDefinition/us-core-encounter THO
252 hl7VS-relevantClincialInformation StructureDefinition/us-core-specimen THO
253 hl7VS-specimenCondition ValueSet/us-core-specimen-condition THO
254 v2 table 0360 FHIR Value set/code system definition for HL7 v2 table 0360 ver 2.9 ( Degree/License/Certificate) THO
255 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 DICOM Controlled Terminology Definitions http://dicom.nema.org/resources/ontology/DCM ValueSet/dicom-dicom-cid-29-AcquisitionModality
ValueSet/security-role-type
Other
2 AHA NUBC Patient Discharge Status Codes https://www.nubc.org/CodeSystem/PatDischargeStatus ValueSet/v3-USEncounterDischargeDisposition Other
3 ActCode http://terminology.hl7.org/CodeSystem/v3-ActCode ValueSet/v3-ActPharmacySupplyType
ValueSet/v3-ActCode
ValueSet/provenance-activity-type
ValueSet/v3-ActEncounterCode
THO
4 ActPriority http://terminology.hl7.org/CodeSystem/v3-ActPriority ValueSet/v3-ActPriority THO
5 ActReason http://terminology.hl7.org/CodeSystem/v3-ActReason ValueSet/v3-PurposeOfUse
ValueSet/v3-SubstanceAdminSubstitutionReason
ValueSet/v3-ActNoImmunizationReason
THO
6 ActSite http://terminology.hl7.org/CodeSystem/v3-ActSite ValueSet/immunization-site THO
7 AddressType http://hl7.org/fhir/address-type ValueSet/address-type FHIR
8 AddressUse http://hl7.org/fhir/address-use ValueSet/address-use FHIR
9 AdministrativeGender http://hl7.org/fhir/administrative-gender ValueSet/administrative-gender FHIR
10 Admit source http://terminology.hl7.org/CodeSystem/admit-source ValueSet/encounter-admit-source THO
11 AllergyIntolerance Clinical Status Codes http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical ValueSet/allergyintolerance-clinical THO
12 AllergyIntolerance Verification Status http://terminology.hl7.org/CodeSystem/allergyintolerance-verification ValueSet/allergyintolerance-verification THO
13 AllergyIntoleranceCategory http://hl7.org/fhir/allergy-intolerance-category ValueSet/allergy-intolerance-category FHIR
14 AllergyIntoleranceCriticality http://hl7.org/fhir/allergy-intolerance-criticality ValueSet/allergy-intolerance-criticality FHIR
15 AllergyIntoleranceSeverity http://hl7.org/fhir/reaction-event-severity ValueSet/reaction-event-severity FHIR
16 AllergyIntoleranceType http://hl7.org/fhir/allergy-intolerance-type ValueSet/allergy-intolerance-type FHIR
17 Appointment cancellation reason http://terminology.hl7.org/CodeSystem/appointment-cancellation-reason ValueSet/appointment-cancellation-reason THO
18 AppointmentStatus http://hl7.org/fhir/appointmentstatus ValueSet/appointmentstatus FHIR
19 CarePlanActivityStatus http://hl7.org/fhir/care-plan-activity-status ValueSet/care-plan-activity-status FHIR
20 CareTeamStatus http://hl7.org/fhir/care-team-status ValueSet/care-team-status FHIR
21 Code on Dental Procedures and Nomenclature http://www.ada.org/cdt ValueSet/us-core-procedure-code Other
22 Common Tags http://terminology.hl7.org/CodeSystem/common-tags ValueSet/common-tags THO
23 CompositionStatus http://hl7.org/fhir/composition-status ValueSet/composition-status FHIR
24 Condition Category Codes http://terminology.hl7.org/CodeSystem/condition-category ValueSet/condition-category
ValueSet/us-core-problem-or-health-concern
THO
25 Condition Clinical Status Codes http://terminology.hl7.org/CodeSystem/condition-clinical ValueSet/condition-clinical THO
26 ConditionVerificationStatus http://terminology.hl7.org/CodeSystem/condition-ver-status ValueSet/condition-ver-status THO
27 Contact entity type http://terminology.hl7.org/CodeSystem/contactentity-type ValueSet/contactentity-type THO
28 ContactPointSystem http://hl7.org/fhir/contact-point-system ValueSet/contact-point-system FHIR
29 ContactPointUse http://hl7.org/fhir/contact-point-use ValueSet/contact-point-use FHIR
30 Contract Signer Type Codes http://terminology.hl7.org/CodeSystem/contractsignertypecodes ValueSet/security-role-type THO
31 Coverage Class Codes http://terminology.hl7.org/CodeSystem/coverage-class ValueSet/coverage-class THO
32 Coverage Copay Type Codes http://terminology.hl7.org/CodeSystem/coverage-copay-type ValueSet/coverage-copay-type THO
33 Current Procedural Terminology (CPT®) http://www.ama-assn.org/go/cpt ValueSet/us-core-procedure-code Other
34 DataAbsentReason http://terminology.hl7.org/CodeSystem/data-absent-reason ValueSet/data-absent-reason THO
35 DataOperation http://terminology.hl7.org/CodeSystem/v3-DataOperation ValueSet/provenance-activity-type THO
36 DaysOfWeek http://hl7.org/fhir/days-of-week ValueSet/days-of-week FHIR
37 DeviceNameType http://hl7.org/fhir/device-nametype ValueSet/device-nametype FHIR
38 Diagnosis Role http://terminology.hl7.org/CodeSystem/diagnosis-role ValueSet/diagnosis-role THO
39 DiagnosticReportStatus http://hl7.org/fhir/diagnostic-report-status ValueSet/diagnostic-report-status FHIR
40 Diet http://terminology.hl7.org/CodeSystem/diet ValueSet/encounter-diet THO
41 DocumentCompletion http://terminology.hl7.org/CodeSystem/v3-DocumentCompletion ValueSet/provenance-activity-type THO
42 DocumentReferenceStatus http://hl7.org/fhir/document-reference-status ValueSet/document-reference-status FHIR
43 DocumentRelationshipType http://hl7.org/fhir/document-relationship-type ValueSet/document-relationship-type FHIR
44 DoseAndRateType http://terminology.hl7.org/CodeSystem/dose-rate-type ValueSet/dose-rate-type THO
45 EncounterLocationStatus http://hl7.org/fhir/encounter-location-status ValueSet/encounter-location-status FHIR
46 EncounterSpecialCourtesy http://terminology.hl7.org/CodeSystem/v3-EncounterSpecialCourtesy ValueSet/encounter-special-courtesy THO
47 EncounterStatus http://hl7.org/fhir/encounter-status ValueSet/encounter-status FHIR
48 Enteral Formula Additive Type Code http://terminology.hl7.org/CodeSystem/entformula-additive ValueSet/entformula-additive THO
49 EventStatus http://hl7.org/fhir/event-status ValueSet/immunization-status
ValueSet/event-status
FHIR
50 Example Coverage Financial Exception Codes http://terminology.hl7.org/CodeSystem/ex-coverage-financial-exception ValueSet/coverage-financial-exception THO
51 FHIRDeviceStatus http://hl7.org/fhir/device-status ValueSet/device-status FHIR
52 FHIRDeviceStatusReason http://terminology.hl7.org/CodeSystem/device-status-reason ValueSet/device-status-reason THO
53 FamilyHistoryAbsentReason http://terminology.hl7.org/CodeSystem/history-absent-reason ValueSet/history-absent-reason THO
54 FamilyHistoryStatus http://hl7.org/fhir/history-status ValueSet/history-status FHIR
55 Financial Resource Status Codes http://hl7.org/fhir/fm-status ValueSet/fm-status FHIR
56 Goal achievement status http://terminology.hl7.org/CodeSystem/goal-achievement ValueSet/goal-achievement THO
57 Goal category http://terminology.hl7.org/CodeSystem/goal-category ValueSet/goal-category THO
58 Goal priority http://terminology.hl7.org/CodeSystem/goal-priority ValueSet/goal-priority THO
59 GoalLifecycleStatus http://hl7.org/fhir/goal-status ValueSet/goal-status FHIR
60 HL7 Document Format Codes http://terminology.hl7.org/CodeSystem/v3-HL7DocumentFormatCodes ValueSet/v3-HL7FormatCodes THO
61 Healthcare Common Procedure Coding System (HCPCS) level II alphanumeric codes http://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets ValueSet/us-core-procedure-code Other
62 ICD-10 Procedure Codes http://www.cms.gov/Medicare/Coding/ICD10 ValueSet/us-core-procedure-code Other
63 ICD-9-CM (procedure codes) http://hl7.org/fhir/sid/icd-9-cm ValueSet/us-core-condition-code CDC
64 IdentifierUse http://hl7.org/fhir/identifier-use ValueSet/identifier-use FHIR
65 ImagingStudyStatus http://hl7.org/fhir/imagingstudy-status ValueSet/imagingstudy-status FHIR
66 Immunization Funding Source http://terminology.hl7.org/CodeSystem/immunization-funding-source ValueSet/immunization-funding-source THO
67 Immunization Origin Codes http://terminology.hl7.org/CodeSystem/immunization-origin ValueSet/immunization-origin THO
68 Immunization Program Eligibility http://terminology.hl7.org/CodeSystem/immunization-program-eligibility ValueSet/immunization-program-eligibility THO
69 Immunization Subpotent Reason http://terminology.hl7.org/CodeSystem/immunization-subpotent-reason ValueSet/immunization-subpotent-reason THO
70 International Classification of Diseases http://hl7.org/fhir/sid/icd-10-cm Clinical Modification (ICD-10-CM) CDC
71 LinkType http://hl7.org/fhir/link-type ValueSet/link-type FHIR
72 Location type http://terminology.hl7.org/CodeSystem/location-physical-type ValueSet/location-physical-type THO
73 LocationMode http://hl7.org/fhir/location-mode ValueSet/location-mode FHIR
74 LocationStatus http://hl7.org/fhir/location-status ValueSet/location-status FHIR
75 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
76 MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus ValueSet/marital-status THO
77 Medication status codes http://hl7.org/fhir/CodeSystem/medication-status ValueSet/medication-status FHIR
78 Medication administration category codes http://terminology.hl7.org/CodeSystem/medication-admin-category ValueSet/medication-admin-category THO
79 Medication administration status codes http://terminology.hl7.org/CodeSystem/medication-admin-status ValueSet/medication-admin-status THO
80 Medication dispense category codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category ValueSet/medicationdispense-category THO
81 Medication dispense status codes http://terminology.hl7.org/CodeSystem/medicationdispense-status ValueSet/medicationdispense-status THO
82 Medication dispense status reason codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-status-reason ValueSet/medicationdispense-status-reason THO
83 Medication request intent http://hl7.org/fhir/CodeSystem/medicationrequest-intent ValueSet/medicationrequest-intent FHIR
84 MedicationAdministration Performer Function Codes http://terminology.hl7.org/CodeSystem/med-admin-perform-function ValueSet/med-admin-perform-function THO
85 MedicationDispense Performer Function Codes http://terminology.hl7.org/CodeSystem/medicationdispense-performer-function ValueSet/medicationdispense-performer-function THO
86 MedicationRequest Category Codes http://terminology.hl7.org/CodeSystem/medicationrequest-category ValueSet/medicationrequest-category THO
87 MedicationRequest Course of Therapy Codes http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy ValueSet/medicationrequest-course-of-therapy THO
88 MedicationRequest Status Reason Codes http://terminology.hl7.org/CodeSystem/medicationrequest-status-reason ValueSet/medicationrequest-status-reason THO
89 Medicationrequest status http://hl7.org/fhir/CodeSystem/medicationrequest-status ValueSet/medicationrequest-status FHIR
90 NameUse http://hl7.org/fhir/name-use ValueSet/name-use FHIR
91 NarrativeStatus http://hl7.org/fhir/narrative-status ValueSet/us-core-narrative-status FHIR
92 NullFlavor http://terminology.hl7.org/CodeSystem/v3-NullFlavor ValueSet/us-core-documentreference-type
ValueSet/marital-status
ValueSet/encounter-special-courtesy
THO
93 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
94 Observation Reference Range Meaning Codes http://terminology.hl7.org/CodeSystem/referencerange-meaning ValueSet/referencerange-meaning THO
95 ObservationInterpretation http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation ValueSet/observation-interpretation THO
96 ObservationStatus http://hl7.org/fhir/observation-status ValueSet/us-core-observation-smoking-status-status
ValueSet/observation-status
FHIR
97 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
98 Organization type http://terminology.hl7.org/CodeSystem/organization-type ValueSet/organization-type THO
99 Participant type http://terminology.hl7.org/CodeSystem/participant-type ValueSet/encounter-participant-type THO
100 ParticipantRequired http://hl7.org/fhir/participantrequired ValueSet/participantrequired FHIR
101 ParticipationFunction http://terminology.hl7.org/CodeSystem/v3-ParticipationFunction ValueSet/security-role-type THO
102 ParticipationStatus http://hl7.org/fhir/participationstatus ValueSet/participationstatus FHIR
103 ParticipationType http://terminology.hl7.org/CodeSystem/v3-ParticipationType ValueSet/series-performer-function
ValueSet/security-role-type
ValueSet/encounter-participant-type
ValueSet/provenance-activity-type
THO
104 Provenance participant type http://terminology.hl7.org/CodeSystem/provenance-participant-type ValueSet/provenance-agent-type THO
105 ProvenanceEntityRole http://hl7.org/fhir/provenance-entity-role ValueSet/provenance-entity-role FHIR
106 QuantityComparator http://hl7.org/fhir/quantity-comparator ValueSet/quantity-comparator FHIR
107 QuestionnaireResponseStatus http://hl7.org/fhir/questionnaire-answers-status ValueSet/questionnaire-answers-status FHIR
108 Reason Medication Given Codes http://terminology.hl7.org/CodeSystem/reason-medication-given ValueSet/reason-medication-given-codes THO
109 RequestIntent http://hl7.org/fhir/request-intent ValueSet/request-intent
ValueSet/care-plan-intent
FHIR
110 RequestPriority http://hl7.org/fhir/request-priority ValueSet/request-priority FHIR
111 RequestStatus http://hl7.org/fhir/request-status ValueSet/request-status FHIR
112 ResourceType http://hl7.org/fhir/resource-types ValueSet/resource-types
ValueSet/care-plan-activity-kind
FHIR
113 RoleClass http://terminology.hl7.org/CodeSystem/v3-RoleClass ValueSet/security-role-type THO
114 RoleCode http://terminology.hl7.org/CodeSystem/v3-RoleCode ValueSet/security-role-type
ValueSet/vsac-2.16.840.1.113883.1.11.19579-20250724
ValueSet/v3-ServiceDeliveryLocationRoleType
ValueSet/vsac-2.16.840.1.113883.11.20.12.1-20251204
THO
115 RouteOfAdministration http://terminology.hl7.org/CodeSystem/v3-RouteOfAdministration ValueSet/enteral-route
ValueSet/immunization-route
THO
116 SNOMED CT (all versions) http://snomed.info/sct ValueSet/servicerequest-category
ValueSet/specimen-container-type
ValueSet/vsac-2.16.840.1.113762.1.4.1267.44-20261021
ValueSet/procedure-followup
ValueSet/supplement-type
ValueSet/medication-form-codes
ValueSet/texture-code
ValueSet/body-site
ValueSet/manifestation-or-symptom
ValueSet/procedure-code
ValueSet/goal-start-event
ValueSet/modified-foodtype
ValueSet/medication-as-needed-reason
ValueSet/c80-facilitycodes
ValueSet/vsac-2.16.840.1.113762.1.4.1021.121-20250228
ValueSet/immunization-reason
ValueSet/substance-code
ValueSet/observation-methods
ValueSet/care-plan-category
ValueSet/us-core-procedure-code
ValueSet/questionnaire-answers
ValueSet/servicerequest-orderdetail
ValueSet/entformula-type
ValueSet/vsac-2.16.840.1.113762.1.4.1166.22-20230802
ValueSet/bodysite-laterality
ValueSet/clinical-findings
ValueSet/condition-stage
ValueSet/immunization-target-disease
ValueSet/encounter-reason
ValueSet/additional-instruction-codes
ValueSet/participant-role
ValueSet/nutrient-code
ValueSet/approach-site-codes
ValueSet/device-action
ValueSet/vsac-2.16.840.1.113762.1.4.1099.54-20240606
ValueSet/us-core-condition-code
ValueSet/medication-codes
ValueSet/diet-type
ValueSet/vsac-2.16.840.1.113762.1.4.1267.3-20261021
ValueSet/reason-medication-not-given-codes
ValueSet/device-kind
ValueSet/performer-role
ValueSet/us-core-servicerequest-category
ValueSet/referencerange-appliesto
ValueSet/food-type
ValueSet/c80-practice-codes
ValueSet/route-codes
ValueSet/procedure-reason
ValueSet/procedure-outcome
ValueSet/care-plan-activity-outcome
ValueSet/procedure-category
ValueSet/condition-code
ValueSet/consistency-type
ValueSet/condition-stage-type
ValueSet/procedure-not-performed-reason
ValueSet/condition-outcome
ValueSet/administration-method-codes
ValueSet/condition-severity
SNOMED
117 Security Role Type http://terminology.hl7.org/CodeSystem/extra-security-role-type ValueSet/security-role-type THO
118 Service category http://terminology.hl7.org/CodeSystem/service-category ValueSet/service-category THO
119 Service type http://terminology.hl7.org/CodeSystem/service-type ValueSet/service-type THO
120 Source of Payment Typology https://nahdo.org/sopt ValueSet/vsac-2.16.840.1.114222.4.11.3591-20250419 CDC
121 Special arrangements http://terminology.hl7.org/CodeSystem/encounter-special-arrangements ValueSet/encounter-special-arrangements THO
122 SpecimenStatus http://hl7.org/fhir/specimen-status ValueSet/specimen-status FHIR
123 SubscriberPolicyholder Relationship Codes http://terminology.hl7.org/CodeSystem/subscriber-relationship ValueSet/subscriber-relationship THO
124 Substance Admin Substitution http://terminology.hl7.org/CodeSystem/v3-substanceAdminSubstitution ValueSet/v3-ActSubstanceAdminSubstitutionCode THO
125 Tags for the Identification of Languages urn:ietf:bcp:47 ValueSet/languages
ValueSet/Languages
Other
126 TribalEntityUS http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS ValueSet/v3-TribalEntityUS THO
127 UDIEntryType http://hl7.org/fhir/udi-entry-type ValueSet/udi-entry-type FHIR
128 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-screening-assessment-condition-category
ValueSet/us-core-servicerequest-category
ValueSet/us-core-screening-assessment-observation-maximum-category
US CORE
129 US Core Condition Category Extension Codes http://hl7.org/fhir/us/core/CodeSystem/condition-category ValueSet/us-core-problem-or-health-concern US CORE
130 US Core DocumentReferences Category Codes http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category ValueSet/us-core-documentreference-category US CORE
131 USPS State Codes https://www.usps.com/ ValueSet/USPS-State Other
132 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
133 Vaccine Administered Code Set (CVX) http://hl7.org/fhir/sid/cvx ValueSet/vsac-2.16.840.1.113762.1.4.1010.6-20260428 CDC
134 additivePreservative http://terminology.hl7.org/CodeSystem/v2-0371 ValueSet/v2-0371 THO
135 appointmentReason http://terminology.hl7.org/CodeSystem/v2-0276 ValueSet/v2-0276 THO
136 bedStatus http://terminology.hl7.org/CodeSystem/v2-0116 ValueSet/v2-0116 THO
137 contactRole2 http://terminology.hl7.org/CodeSystem/v2-0131 ValueSet/patient-contactrelationship THO
138 diagnosticServiceSectionId http://terminology.hl7.org/CodeSystem/v2-0074 ValueSet/diagnostic-service-sections THO
139 identifierType http://terminology.hl7.org/CodeSystem/v2-0203 ValueSet/identifier-type THO
140 providerRole http://terminology.hl7.org/CodeSystem/v2-0443 ValueSet/immunization-function THO
141 re-admissionIndicator http://terminology.hl7.org/CodeSystem/v2-0092 ValueSet/v2-0092 THO
142 relevantClincialInformation http://terminology.hl7.org/CodeSystem/v2-0916 ValueSet/v2-0916 THO
143 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 Access 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 Tobacco And Nicotine Use 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