US Core Implementation Guide
9.0.0-ballot - STU 9 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 9.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 Version of US Core that is published also publishes a snapshot of the latest versions of code systems and value sets and their expansions at the time of publication. However, US Core does not "pin" the version of the terminology to a specific version of US Core, which means the canonical references to them point to their latest version. For example, in US Core …(example here)… The "Unpinned" terminology more accurately reflects real-world usage of US Core. When implementing US Core, implementers should use the published versions or later versions of the value sets and code systems. In some cases, implementers may need to use terminology from earlier versions to preserve legacy data.

Value Set Packages

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

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

US Core 6.1.0 (published June 2023)

US Core 8.0.1 (published June 2025)

US Core 9.0.0 (published June 2026)

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

Value Sets

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

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

Value Sets Used in US Core

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

Value Set Sources:

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

Code Systems

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

US Core Defined Code Systems

Code System Used in US Core

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

Code System Sources:

Row # Code System Code System URI Value Sets Where Used Source
1 AHA NUBC Patient Discharge Status Codes https://www.nubc.org/CodeSystem/PatDischargeStatus ValueSet/v3-USEncounterDischargeDisposition Other
2 ActCode http://terminology.hl7.org/CodeSystem/v3-ActCode ValueSet/v3-ActPharmacySupplyType
ValueSet/v3-ActCode
ValueSet/provenance-activity-type
ValueSet/v3-ActEncounterCode
THO
3 ActPriority http://terminology.hl7.org/CodeSystem/v3-ActPriority ValueSet/v3-ActPriority THO
4 ActReason http://terminology.hl7.org/CodeSystem/v3-ActReason ValueSet/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