US Core Implementation Guide TEST
9.0.0 - CI Build United States of America flag

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

Terminology

Page standards status: Trial-use

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

US Core ValueSet and CodeSystem versions

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

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

Value Set Packages

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

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

US Core 6.1.0 (published June 2023)

US Core 8.0.1 (published June 2025)

US Core 9.0.0 (published June 2026)

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

Value Sets

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

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

Value Sets Used in US Core

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

Value Set Sources:

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

Code Systems

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

US Core Defined Code Systems

Code System Used in US Core

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

Code System Sources:

Row # Code System Code System URI Value Sets Where Used Source
1 AHA NUBC Patient Discharge Status Codes https://www.nubc.org/CodeSystem/PatDischargeStatus ValueSet/v3-USEncounterDischargeDisposition Other
2 ActCode http://terminology.hl7.org/CodeSystem/v3-ActCode ValueSet/v3-ActPharmacySupplyType
ValueSet/v3-ActCode
ValueSet/provenance-activity-type
ValueSet/v3-ActEncounterCode
THO
3 ActPriority http://terminology.hl7.org/CodeSystem/v3-ActPriority ValueSet/v3-ActPriority THO
4 ActReason http://terminology.hl7.org/CodeSystem/v3-ActReason ValueSet/v3-PurposeOfUse
ValueSet/immunization-status-reason
ValueSet/v3-SubstanceAdminSubstitutionReason
THO
5 ActSite http://terminology.hl7.org/CodeSystem/v3-ActSite ValueSet/immunization-site THO
6 AddressType http://hl7.org/fhir/address-type ValueSet/address-type FHIR
7 AddressUse http://hl7.org/fhir/address-use ValueSet/address-use FHIR
8 AdministrativeGender http://hl7.org/fhir/administrative-gender ValueSet/administrative-gender FHIR
9 Admit source http://terminology.hl7.org/CodeSystem/admit-source ValueSet/encounter-admit-source THO
10 Allergy Intolerance Category http://hl7.org/fhir/allergy-intolerance-category ValueSet/allergy-intolerance-category FHIR
11 Allergy Intolerance Criticality http://hl7.org/fhir/allergy-intolerance-criticality ValueSet/allergy-intolerance-criticality FHIR
12 Allergy Intolerance Severity http://hl7.org/fhir/reaction-event-severity ValueSet/reaction-event-severity FHIR
13 Allergy Intolerance Type http://hl7.org/fhir/allergy-intolerance-type ValueSet/allergy-intolerance-type FHIR
14 AllergyIntolerance Clinical Status Codes http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical ValueSet/allergyintolerance-clinical THO
15 AllergyIntolerance Verification Status http://terminology.hl7.org/CodeSystem/allergyintolerance-verification ValueSet/allergyintolerance-verification THO
16 CMS Place of Service Codes (POS) https://www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set ValueSet/CMSPlaceOfServiceCodes Other
17 Care Team Status http://hl7.org/fhir/care-team-status ValueSet/care-team-status FHIR
18 CarePlanActivityStatus http://hl7.org/fhir/care-plan-activity-status ValueSet/care-plan-activity-status FHIR
19 Code on Dental Procedures and Nomenclature http://www.ada.org/cdt ValueSet/us-core-procedure-code Other
20 Common Tags http://terminology.hl7.org/CodeSystem/common-tags ValueSet/common-tags THO
21 Composition Status http://hl7.org/fhir/composition-status ValueSet/composition-status FHIR
22 Condition Category Codes http://terminology.hl7.org/CodeSystem/condition-category ValueSet/condition-category
ValueSet/us-core-problem-or-health-concern
THO
23 Condition Clinical Status Codes http://terminology.hl7.org/CodeSystem/condition-clinical ValueSet/condition-clinical THO
24 ConditionVerificationStatus http://terminology.hl7.org/CodeSystem/condition-ver-status ValueSet/condition-ver-status THO
25 Contact entity type http://terminology.hl7.org/CodeSystem/contactentity-type ValueSet/contactentity-type THO
26 ContactPointSystem http://hl7.org/fhir/contact-point-system ValueSet/contact-point-system FHIR
27 ContactPointUse http://hl7.org/fhir/contact-point-use ValueSet/contact-point-use FHIR
28 Contract Signer Type Codes http://terminology.hl7.org/CodeSystem/contractsignertypecodes ValueSet/security-role-type THO
29 Coverage Class Codes http://terminology.hl7.org/CodeSystem/coverage-class ValueSet/coverage-class THO
30 Coverage Copay Type Codes http://terminology.hl7.org/CodeSystem/coverage-copay-type ValueSet/coverage-copay-type THO
31 Current Procedural Terminology (CPT®) http://www.ama-assn.org/go/cpt ValueSet/us-core-procedure-code Other
32 DICOM Controlled Terminology http://dicom.nema.org/resources/ontology/DCM ValueSet/security-role-type Other
33 DataAbsentReason http://terminology.hl7.org/CodeSystem/data-absent-reason ValueSet/data-absent-reason THO
34 DataOperation http://terminology.hl7.org/CodeSystem/v3-DataOperation ValueSet/provenance-activity-type THO
35 Days Of Week http://hl7.org/fhir/days-of-week ValueSet/days-of-week FHIR
36 Device Name Type http://hl7.org/fhir/device-nametype ValueSet/device-nametype FHIR
37 Diagnosis Role http://terminology.hl7.org/CodeSystem/diagnosis-role ValueSet/diagnosis-role THO
38 Diagnostic Report Status http://hl7.org/fhir/diagnostic-report-status ValueSet/diagnostic-report-status FHIR
39 Diet http://terminology.hl7.org/CodeSystem/diet ValueSet/encounter-diet THO
40 Document Relationship Type http://hl7.org/fhir/document-relationship-type ValueSet/document-relationship-type FHIR
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 DoseAndRateType http://terminology.hl7.org/CodeSystem/dose-rate-type ValueSet/dose-rate-type THO
44 Encounter Location Status http://hl7.org/fhir/encounter-location-status ValueSet/encounter-location-status FHIR
45 Encounter Status http://hl7.org/fhir/encounter-status ValueSet/encounter-status FHIR
46 EncounterSpecialCourtesy http://terminology.hl7.org/CodeSystem/v3-EncounterSpecialCourtesy ValueSet/encounter-special-courtesy THO
47 EventStatus http://hl7.org/fhir/event-status ValueSet/immunization-status
ValueSet/event-status
FHIR
48 Example Coverage Financial Exception Codes http://terminology.hl7.org/CodeSystem/ex-coverage-financial-exception ValueSet/coverage-financial-exception THO
49 FHIR Device Status http://hl7.org/fhir/device-status ValueSet/device-status FHIR
50 FHIRDeviceStatusReason http://terminology.hl7.org/CodeSystem/device-status-reason ValueSet/device-status-reason THO
51 Family History Status http://hl7.org/fhir/history-status ValueSet/history-status FHIR
52 FamilyHistoryAbsentReason http://terminology.hl7.org/CodeSystem/history-absent-reason ValueSet/history-absent-reason THO
53 Financial Resource Status Codes http://hl7.org/fhir/fm-status ValueSet/fm-status FHIR
54 Goal Lifecycle Status http://hl7.org/fhir/goal-status ValueSet/goal-status FHIR
55 Goal achievement status http://terminology.hl7.org/CodeSystem/goal-achievement ValueSet/goal-achievement THO
56 Goal category http://terminology.hl7.org/CodeSystem/goal-category ValueSet/goal-category THO
57 Goal priority http://terminology.hl7.org/CodeSystem/goal-priority ValueSet/goal-priority THO
58 HL7 Document Format Codes http://terminology.hl7.org/CodeSystem/v3-HL7DocumentFormatCodes ValueSet/v3-HL7FormatCodes THO
59 Healthcare Common Procedure Coding System (HCPCS) level II alphanumeric codes http://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets ValueSet/us-core-procedure-code Other
60 ICD-10 Procedure Codes http://www.cms.gov/Medicare/Coding/ICD10 ValueSet/us-core-procedure-code Other
61 ICD-9-CM (procedure codes) http://hl7.org/fhir/sid/icd-9-cm ValueSet/us-core-condition-code CDC
62 IHE Format Code set for use with Document Sharing http://ihe.net/fhir/ihe.formatcode.fhir/CodeSystem/formatcode ValueSet/v3-HL7FormatCodes Other
63 IdentifierUse http://hl7.org/fhir/identifier-use ValueSet/identifier-use FHIR
64 Immunization Funding Source http://terminology.hl7.org/CodeSystem/immunization-funding-source ValueSet/immunization-funding-source THO
65 Immunization Origin Codes http://terminology.hl7.org/CodeSystem/immunization-origin ValueSet/immunization-origin THO
66 Immunization Program Eligibility http://terminology.hl7.org/CodeSystem/immunization-program-eligibility ValueSet/immunization-program-eligibility THO
67 Immunization Subpotent Reason http://terminology.hl7.org/CodeSystem/immunization-subpotent-reason ValueSet/immunization-subpotent-reason THO
68 International Classification of Diseases http://hl7.org/fhir/sid/icd-10-cm Clinical Modification (ICD-10-CM) CDC
69 Link Type http://hl7.org/fhir/link-type ValueSet/link-type FHIR
70 Location Mode http://hl7.org/fhir/location-mode ValueSet/location-mode FHIR
71 Location Status http://hl7.org/fhir/location-status ValueSet/location-status FHIR
72 Location type http://terminology.hl7.org/CodeSystem/location-physical-type ValueSet/location-physical-type THO
73 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
74 MaritalStatus http://terminology.hl7.org/CodeSystem/v3-MaritalStatus ValueSet/marital-status THO
75 Medication Status Codes http://hl7.org/fhir/CodeSystem/medication-status ValueSet/medication-status FHIR
76 Medication dispense category codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category ValueSet/medicationdispense-category THO
77 Medication dispense status codes http://terminology.hl7.org/CodeSystem/medicationdispense-status ValueSet/medicationdispense-status THO
78 Medication dispense status reason codes http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-status-reason ValueSet/medicationdispense-status-reason THO
79 MedicationDispense Performer Function Codes http://terminology.hl7.org/CodeSystem/medicationdispense-performer-function ValueSet/medicationdispense-performer-function THO
80 MedicationRequest Category Codes http://terminology.hl7.org/CodeSystem/medicationrequest-category ValueSet/medicationrequest-category THO
81 MedicationRequest Course of Therapy Codes http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy ValueSet/medicationrequest-course-of-therapy THO
82 MedicationRequest Intent Codes http://hl7.org/fhir/CodeSystem/medicationrequest-intent ValueSet/medicationrequest-intent FHIR
83 MedicationRequest Status Codes http://hl7.org/fhir/CodeSystem/medicationrequest-status ValueSet/medicationrequest-status FHIR
84 MedicationRequest Status Reason Codes http://terminology.hl7.org/CodeSystem/medicationrequest-status-reason ValueSet/medicationrequest-status-reason THO
85 NameUse http://hl7.org/fhir/name-use ValueSet/name-use FHIR
86 NarrativeStatus http://hl7.org/fhir/narrative-status ValueSet/us-core-narrative-status FHIR
87 NullFlavor http://terminology.hl7.org/CodeSystem/v3-NullFlavor ValueSet/us-core-documentreference-type
ValueSet/marital-status
ValueSet/encounter-special-courtesy
THO
88 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
89 Observation Reference Range Meaning Codes http://terminology.hl7.org/CodeSystem/referencerange-meaning ValueSet/referencerange-meaning THO
90 Observation Status http://hl7.org/fhir/observation-status ValueSet/us-core-observation-smoking-status-status
ValueSet/observation-status
FHIR
91 ObservationInterpretation http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation ValueSet/observation-interpretation THO
92 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
93 Organization type http://terminology.hl7.org/CodeSystem/organization-type ValueSet/organization-type THO
94 Participant type http://terminology.hl7.org/CodeSystem/participant-type ValueSet/encounter-participant-type THO
95 ParticipationFunction http://terminology.hl7.org/CodeSystem/v3-ParticipationFunction ValueSet/security-role-type THO
96 ParticipationType http://terminology.hl7.org/CodeSystem/v3-ParticipationType ValueSet/security-role-type
ValueSet/encounter-participant-type
ValueSet/provenance-activity-type
THO
97 Provenance Entity Role http://hl7.org/fhir/provenance-entity-role ValueSet/provenance-entity-role FHIR
98 Provenance participant type http://terminology.hl7.org/CodeSystem/provenance-participant-type ValueSet/provenance-agent-type THO
99 QuantityComparator http://hl7.org/fhir/quantity-comparator ValueSet/quantity-comparator FHIR
100 Questionnaire Response Status http://hl7.org/fhir/questionnaire-answers-status ValueSet/questionnaire-answers-status FHIR
101 RequestIntent http://hl7.org/fhir/request-intent ValueSet/request-intent
ValueSet/care-plan-intent
FHIR
102 RequestPriority http://hl7.org/fhir/request-priority ValueSet/request-priority FHIR
103 RequestStatus http://hl7.org/fhir/request-status ValueSet/request-status FHIR
104 ResourceType http://hl7.org/fhir/resource-types ValueSet/resource-types
ValueSet/care-plan-activity-kind
FHIR
105 RoleClass http://terminology.hl7.org/CodeSystem/v3-RoleClass ValueSet/security-role-type THO
106 RoleCode http://terminology.hl7.org/CodeSystem/v3-RoleCode ValueSet/security-role-type
ValueSet/relatedperson-relationshiptype
ValueSet/2.16.840.1.113883.1.11.19579
ValueSet/v3-ServiceDeliveryLocationRoleType
THO
107 RouteOfAdministration http://terminology.hl7.org/CodeSystem/v3-RouteOfAdministration ValueSet/immunization-route THO
108 SNOMED CT (all versions) http://snomed.info/sct ValueSet/servicerequest-category
ValueSet/specimen-container-type
ValueSet/2.16.840.1.113762.1.4.1099.54
ValueSet/procedure-followup
ValueSet/us-core-goal-description
ValueSet/specimen-collection-method
ValueSet/us-core-condition-code-current
ValueSet/medication-form-codes
ValueSet/body-site
ValueSet/manifestation-or-symptom
ValueSet/goal-start-event
ValueSet/procedure-code
ValueSet/medication-as-needed-reason
ValueSet/2.16.840.1.113762.1.4.1166.22
ValueSet/c80-facilitycodes
ValueSet/2.16.840.1.113762.1.4.1267.3
ValueSet/immunization-reason
ValueSet/substance-code
ValueSet/observation-methods
ValueSet/us-core-procedure-code
ValueSet/care-plan-category
ValueSet/questionnaire-answers
ValueSet/servicerequest-orderdetail
ValueSet/clinical-findings
ValueSet/condition-stage
ValueSet/immunization-target-disease
ValueSet/encounter-reason
ValueSet/additional-instruction-codes
ValueSet/participant-role
ValueSet/approach-site-codes
ValueSet/device-action
ValueSet/us-core-condition-code
ValueSet/medication-codes
ValueSet/device-kind
ValueSet/performer-role
ValueSet/us-core-servicerequest-category
ValueSet/c80-practice-codes
ValueSet/referencerange-appliesto
ValueSet/route-codes
ValueSet/care-plan-activity-outcome
ValueSet/procedure-outcome
ValueSet/procedure-reason
ValueSet/2.16.840.1.113762.1.4.1021.121
ValueSet/procedure-category
ValueSet/condition-code
ValueSet/condition-stage-type
ValueSet/procedure-not-performed-reason
ValueSet/immunization-status-reason
ValueSet/condition-outcome
ValueSet/administration-method-codes
ValueSet/condition-severity
SNOMED
109 Security Role Type http://terminology.hl7.org/CodeSystem/extra-security-role-type ValueSet/security-role-type THO
110 Service type http://terminology.hl7.org/CodeSystem/service-type ValueSet/service-type THO
111 Source of Payment Typology https://nahdo.org/sopt ValueSet/2.16.840.1.114222.4.11.3591 CDC
112 Special arrangements http://terminology.hl7.org/CodeSystem/encounter-special-arrangements ValueSet/encounter-special-arrangements THO
113 Specimen Status http://hl7.org/fhir/specimen-status ValueSet/specimen-status FHIR
114 SubscriberPolicyholder Relationship Codes http://terminology.hl7.org/CodeSystem/subscriber-relationship ValueSet/subscriber-relationship THO
115 Substance Admin Substitution http://terminology.hl7.org/CodeSystem/v3-substanceAdminSubstitution ValueSet/v3-ActSubstanceAdminSubstitutionCode THO
116 Tags for the Identification of Languages urn:ietf:bcp:47 ValueSet/languages
ValueSet/Languages
Other
117 TribalEntityUS http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS ValueSet/v3-TribalEntityUS THO
118 UDI Entry Type http://hl7.org/fhir/udi-entry-type ValueSet/udi-entry-type FHIR
119 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
120 US Core Condition Category Extension Codes http://hl7.org/fhir/us/core/CodeSystem/condition-category ValueSet/us-core-problem-or-health-concern US CORE
121 US Core DocumentReferences Category Codes http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category ValueSet/us-core-documentreference-category US CORE
122 USPS State Codes https://www.usps.com/ ValueSet/USPS-State Other
123 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
124 Vaccine Administered Code Set (CVX) http://hl7.org/fhir/sid/cvx ValueSet/2.16.840.1.113762.1.4.1010.6 CDC
125 additivePreservative http://terminology.hl7.org/CodeSystem/v2-0371 ValueSet/v2-0371 THO
126 bedStatus http://terminology.hl7.org/CodeSystem/v2-0116 ValueSet/v2-0116 THO
127 contactRole2 http://terminology.hl7.org/CodeSystem/v2-0131 ValueSet/relatedperson-relationshiptype
ValueSet/patient-contactrelationship
THO
128 diagnosticServiceSectionId http://terminology.hl7.org/CodeSystem/v2-0074 ValueSet/diagnostic-service-sections THO
129 identifierType http://terminology.hl7.org/CodeSystem/v2-0203 ValueSet/identifier-type THO
130 providerRole http://terminology.hl7.org/CodeSystem/v2-0443 ValueSet/immunization-function THO
131 re-admissionIndicator http://terminology.hl7.org/CodeSystem/v2-0092 ValueSet/v2-0092 THO
132 relevantClincialInformation http://terminology.hl7.org/CodeSystem/v2-0916 ValueSet/v2-0916 THO
133 treatment http://terminology.hl7.org/CodeSystem/v2-0373 ValueSet/specimen-processing-procedure THO

The Value Set Authority Center (VSAC)

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

How to Acess Value Sets in VSAC

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

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

    An example of this is shown in the screenshots below.

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

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

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

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

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

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

Example

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

Figure 1: VSAC link
vsac-1.png

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

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

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

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