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