HL7 FHIR® US Core Implementation Guide STU3 Release 3.1.1

This page is part of the US Core (v3.1.1: STU3) based on FHIR R4. The current version which supercedes this version is 5.0.1. For a full list of available versions, see the Directory of published versions


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 resources, see the guidance section as well as in the FHIR specification.

Value Sets

These value sets have been defined for this implementation guide.

  • Birth Sex
  • Detailed ethnicity
  • Detailed Race
  • Language codes with language and optionally a region modifier
  • OMB Ethnicity Categories
  • OMB Race Categories
  • US Core CareTeam Provider Roles
  • US Core Clinical Note Type
  • US Core Common substances for allergy and intolerance documentation including refutations
  • US Core Condition Category Codes
  • US Core Condition Code
  • US Core Diagnostic Report Laboratory Codes
  • US Core DiagnosticReport Category
  • US Core Diagnosticreport Report And Note Codes
  • US Core DocumentReference Category
  • US Core DocumentReference Type
  • US Core Encounter Type
  • US Core ICD-10-PCS Procedure Codes
  • US Core Medication Codes (RxNorm)
  • US Core Narrative Status
  • US Core Observation Value Codes (SNOMED-CT)
  • US Core Procedure Codes
  • US Core Provenance Participant Type Codes
  • US Core Provider Role (NUCC)
  • US Core Provider Speciality (NUCC)
  • US Core Smoking Status
  • US Core Status for Smoking Status Observation
  • US Core Smoking Status Observation Codes
  • US Core Vaccine Administered Value Set (CVX)
  • US Core Vaccine National Drug Codes (NDC)
  • USPS Two Letter Alphabetic Codes
  • Code Systems

    See the FHIR terminology section for a complete discussion on code systems and a list of codes system names used in FHIR. The following additional names (URIs) have been identified for this implementation guide, If a URI is listed here, it SHALL be used in the US Core profiles in preference to any other code system name.

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

  • Race & Ethnicity - CDC
  • US Core CarePlan Category Extension Codes
  • US Core Condition Category Extension Codes
  • US Core DocumentReferences Category Codes
  • US Core Provenance Participant Type Extension Codes
  • Externally Published code systems

    URI Source Comment OID (for non-FHIR systems)
    urn:oid:2.16.840.1.113883.6.285 CMS Healthcare Common Procedure Coding System (HCPCS) level II alphanumeric codes 2.16.840.1.113883.6.285
    http://hl7.org/fhir/sid/icd-10-cm CMS International Classification of Diseases, 10th Revision, Clinical Modification (ICD-10-CM) - See Using ICD-[X] with FHIR. 2.16.840.1.113883.6.90
    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://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.


    The following concept mappings have been defined as part of the this guide.

  • US Core NDC to CVX Code Mapping