2026 US Quality Core Implementation Guide
0.5.0 - cibuild US

2026 US Quality Core Implementation Guide, published by Office of the National Coordinator for Health Information Technology (ONC). This guide is not an authorized publication; it is the continuous build for version 0.5.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/FHIR/us-quality-core/ and changes regularly. See the Directory of published versions

## : Patient example - XML Representation

Raw xml | Download

    <Patient xmlns="http://hl7.org/fhir">
      <id value="example"/>
      <meta>
        <profile
                 value="http://fhir.org/guides/onc/us-quality-core/StructureDefinition/us-quality-core-patient"/>
      </meta>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Patient example</b></p><a name="example"> </a><a name="hcexample"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-us-quality-core-patient.html">US Quality Core Patient</a></p></div><p style="border: 1px #661aff solid; background-color: #e6e6ff; padding: 10px;">Jim Chalmers  Male, DoB: 1974-12-25 ( Social Security number (use: usual, period: 2001-05-06 --&gt; (ongoing)))</p><hr/><table class="grid"><tr><td style="background-color: #f3f5da" title="Record is active">Active:</td><td>true</td><td style="background-color: #f3f5da" title="Known status of Patient">Deceased:</td><td colspan="3">false</td></tr><tr><td style="background-color: #f3f5da" title="Ways to contact the Patient">Contact Detail</td><td colspan="3"><ul><li>ph: (03) 5555 6473(Work)</li><li>ph: (03) 3410 5613(Mobile)</li><li>ph: (03) 5555 8834(Old)</li><li>534 Erewhon St PeasantVille, Utah 84414(home)</li></ul></td></tr><tr><td style="background-color: #f3f5da" title="Language spoken">Language:</td><td colspan="3"><span title="Codes:{urn:ietf:bcp:47 en}">English</span></td></tr><tr><td style="background-color: #f3f5da" title="Nominated Contact: Next-of-Kin">Next-of-Kin:</td><td colspan="3"><ul><li>Bénédicte du Marché  (Female)</li><li>534 Erewhon St PleasantVille VT 3999 (home)</li><li><a href="tel:+33(237)998327">+33 (237) 998327</a></li><li>Valid Period:2012 --&gt; (ongoing)</li></ul></td></tr><tr><td style="background-color: #f3f5da" title="Patient Links">Links:</td><td colspan="3"><ul><li>Managing Organization: <a href="Organization-example.html">Organization Health Level Seven International</a></li></ul></td></tr><tr><td style="background-color: #f3f5da" title="Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The ethnicity codes used to represent these concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino.">US Core Ethnicity Extension:</td><td colspan="3"><ul><li>ombCategory: <a href="http://terminology.hl7.org/6.5.0/CodeSystem-CDCREC.html#CDCREC-2186-5">CDC Race and Ethnicity: 2186-5</a> (Not Hispanic or Latino)</li><li>text: Not Hispanic or Latino</li></ul></td></tr><tr><td style="background-color: #f3f5da" title="Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The race codes used to represent these concepts are based upon the [CDC Race and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html#3) which includes over 900 concepts for representing race and ethnicity of which 921 reference race.  The race concepts are grouped by and pre-mapped to the 5 OMB race categories:

     - American Indian or Alaska Native
     - Asian
     - Black or African American
     - Native Hawaiian or Other Pacific Islander
     - White.">US Core Race Extension:</td><td colspan="3"><ul><li>ombCategory: <a href="http://terminology.hl7.org/6.5.0/CodeSystem-CDCREC.html#CDCREC-2106-3">CDC Race and Ethnicity: 2106-3</a> (White)</li><li>text: White</li></ul></td></tr><tr><td style="background-color: #f3f5da" title="This Extension profile represents a tribe or band with which a person associates and, optionally, whether they are enrolled.">US Core Tribal Affiliation Extension:</td><td colspan="3"><ul><li>tribalAffiliation: <span title="Codes:{http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS 187}">Paiute-Shoshone Tribe of the Fallon Reservation and Colony, Nevada</span></li><li>isEnrolled: false</li></ul></td></tr></table></div>
      </text>
      <extension
                 url="http://hl7.org/fhir/us/core/StructureDefinition/us-core-race">
        <extension url="ombCategory">
          <valueCoding>
            <system value="urn:oid:2.16.840.1.113883.6.238"/>
            <code value="2106-3"/>
            <display value="White"/>
          </valueCoding>
        </extension>
        <extension url="text">
          <valueString value="White"/>
        </extension>
      </extension>
      <extension
                 url="http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity">
        <extension url="ombCategory">
          <valueCoding>
            <system value="urn:oid:2.16.840.1.113883.6.238"/>
            <code value="2186-5"/>
            <display value="Not Hispanic or Latino"/>
          </valueCoding>
        </extension>
        <extension url="text">
          <valueString value="Not Hispanic or Latino"/>
        </extension>
      </extension>
      <extension
                 url="http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation">
        <extension url="tribalAffiliation">
          <valueCodeableConcept>
            <coding>
              <system
                      value="http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS"/>
              <code value="187"/>
              <display
                       value="Paiute-Shoshone Tribe of the Fallon Reservation and Colony, Nevada"/>
            </coding>
            <text
                  value="Paiute-Shoshone Tribe of the Fallon Reservation and Colony, Nevada"/>
          </valueCodeableConcept>
        </extension>
        <extension url="isEnrolled">
          <valueBoolean value="false"/>
        </extension>
      </extension>
      <identifier>
        <use value="usual"/>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v2-0203"/>
            <code value="SS"/>
          </coding>
        </type>
        <system value="http://hl7.org/fhir/sid/us-ssn"/>
        <value value="999123456"/>
        <period>
          <start value="2001-05-06"/>
        </period>
        <assigner>
          <display value="Acme Healthcare"/>
        </assigner>
      </identifier>
      <active value="true"/>
      <name>
        <use value="official"/>
        <family value="Chalmers"/>
        <given value="Peter"/>
        <given value="James"/>
        <suffix value="Jr."/>
      </name>
      <name>
        <use value="usual"/>
        <family value="Chalmers"/>
        <given value="Jim"/>
      </name>
      <name>
        <use value="maiden"/>
        <family value="Windsor"/>
        <given value="Peter"/>
        <given value="James"/>
        <period>
          <end value="2002"/>
        </period>
      </name>
      <telecom>
        <system value="phone"/>
        <value value="(03) 5555 6473"/>
        <use value="work"/>
        <rank value="1"/>
      </telecom>
      <telecom>
        <system value="phone"/>
        <value value="(03) 3410 5613"/>
        <use value="mobile"/>
        <rank value="2"/>
      </telecom>
      <telecom>
        <system value="phone"/>
        <value value="(03) 5555 8834"/>
        <use value="old"/>
        <period>
          <end value="2014"/>
        </period>
      </telecom>
      <gender value="male"/>
      <birthDate value="1974-12-25">
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/patient-birthTime">
          <valueDateTime value="1974-12-25T14:35:45-05:00"/>
        </extension>
      </birthDate>
      <deceasedBoolean value="false"/>
      <address>
        <use value="home"/>
        <type value="both"/>
        <text value="534 Erewhon St PeasantVille, Utah 84414"/>
        <line value="534 Erewhon St"/>
        <city value="PleasantVille"/>
        <district value="Rainbow"/>
        <state value="UT"/>
        <postalCode value="84414"/>
        <period>
          <start value="1974-12-25"/>
        </period>
      </address>
      <contact>
        <relationship>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v2-0131"/>
            <code value="N"/>
          </coding>
        </relationship>
        <name>
          <family value="du Marché">
            <extension
                       url="http://hl7.org/fhir/StructureDefinition/humanname-own-prefix">
              <valueString value="VV"/>
            </extension>
          </family>
          <given value="Bénédicte"/>
        </name>
        <telecom>
          <system value="phone"/>
          <value value="+33 (237) 998327"/>
        </telecom>
        <address>
          <use value="home"/>
          <type value="both"/>
          <line value="534 Erewhon St"/>
          <city value="PleasantVille"/>
          <district value="Rainbow"/>
          <state value="VT"/>
          <postalCode value="3999"/>
          <period>
            <start value="1974-12-25"/>
          </period>
        </address>
        <gender value="female"/>
        <period>
          <start value="2012"/>
        </period>
      </contact>
      <communication>
        <language>
          <coding>
            <system value="urn:ietf:bcp:47"/>
            <code value="en"/>
            <display value="English"/>
          </coding>
          <text value="English"/>
        </language>
      </communication>
      <managingOrganization>🔗
        <reference value="Organization/example"/>
      </managingOrganization>
    </Patient>