This page is part of the US Core (v7.0.0-ballot: STU7 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 6.1.0. For a full list of available versions, see the Directory of published versions

Terminology

Page standards status: Informative

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.

Value Sets

Most value sets used in this guide are defined in the base FHIR specification, HL7 Terminology (THO), or Value Set Authority Center (VSAC)]. However, the following value sets sets have been defined for this implementation guide and are not listed elsewhere.

• Birth Sex
• Detailed ethnicity
• Detailed Race
• Language codes with language and optionally a region modifier
• US Core Narrative Status
• OMB Ethnicity Categories
• OMB Race Categories
• US Core Clinical Note Type
• US Core Clinical Result Observation Category
• US Core Condition Codes
• US Core Diagnostic Report Category Codes
• US Core Discharge Disposition
• US Core DocumentReference Category
• US Core DocumentReference Type
• US Core Encounter Type
• US Core Goal Codes
• US Core Laboratory Test Codes
• US Core Non Laboratory Codes
• US Core Status for Smoking Status Observation
• US Core Observation Value Codes (SNOMED-CT)
• US Core Pregnancy Intent Codes
• US Core Pregnancy Status Codes
• US Core Problem or Health Concern
• US Core Procedure Codes
• US Core Provenance Participant Type Codes
• US Core Screening Assessment Condition Category
• US Core Screening Assessment Observation Category
• US Core ServiceRequest Category Codes
• US Core Simple Observation Category
• US Core Simple Observation Codes
• US Core Smoking Status Observation Codes
• US Core Smoking Status Max-Binding
• US Core Survey Codes
• US Core Vital Signs ValueSet
• USPS Two Letter Alphabetic Codes

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. 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.

Code systems published in this IG*- Includes US Core defined code systems and externally defined code systems

• US Core CarePlan Category Extension Codes
• US Core Category
• US Core Condition Category Extension Codes
• US Core DocumentReferences Category Codes
• US Core Provenance Participant Type Extension Codes
• US Core Treatment Intervention Preference CodeSystem

Externally Published code systems

URI	Source	Comment	OID (for non-FHIR systems)
https://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets	CMS	Healthcare Common Procedure Coding System (HCPCS) level II alphanumeric codes	2.16.840.1.113883.6.285
http://www.cms.gov/Medicare/Coding/ICD10	CMS	International Classification of Diseases, 10th Revision, Procedure Coding System (ICD-10-PCS) - See ICD-10 PCS Codes for online access to codes for general information purposes.	2.16.840.1.113883.6.4
http://www.ada.org/cdt	ADA	Code on Dental Procedures and Nomenclature	2.16.840.1.113883.6.13
https://www.usps.com	USPS	United States Postal Service Two–Letter State and Possession Abbreviations	2.16.840.1.113883.6.92

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 for accessing the VSAC value sets and supported code systems. See the table above for a list valuesets used in US core that are defined by 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.

• 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

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:

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

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.