<StructureDefinition xmlns="http://hl7.org/fhir">
  <meta>
    <lastUpdated value="2019-11-14T20:10:48.367+00:00" />
  </meta>
  <url value="http://fhirr4.kids-first.io/fhir/StructureDefinition/us-core-ethnicity" />
  <version value="3.0.0" />
  <name value="USCoreEthnicityExtension" />
  <title value="US Core Ethnicity Extension" />
  <status value="active" />
  <date value="2019-05-21T00:00:00-04:00" />
  <publisher value="HL7 US Realm Steering Committee" />
  <contact>
    <telecom>
      <system value="url" />
      <value value="http://www.healthit.gov" />
    </telecom>
  </contact>
  <description value="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." />
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166" />
      <code value="US" />
      <display value="United States of America" />
    </coding>
  </jurisdiction>
  <purpose value="Complies with 2015 Edition Common Clinical Data Set for patient race." />
  <fhirVersion value="4.0.0" />
  <mapping>
    <identity value="rim" />
    <uri value="http://hl7.org/v3" />
    <name value="RIM Mapping" />
  </mapping>
  <kind value="complex-type" />
  <abstract value="false" />
  <context>
    <type value="element" />
    <expression value="Patient" />
  </context>
  <type value="Extension" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Extension" />
  <derivation value="constraint" />
  <snapshot />
  <differential>
    <element id="Extension:ethnicity">
      <path value="Extension" />
      <short value="US Core ethnicity Extension" />
      <definition value="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." />
      <min value="0" />
      <max value="1" />
      <isModifier value="false" />
    </element>
    <element id="Extension:ethnicity.extension:ombcategory">
      <path value="Extension.extension" />
      <sliceName value="ombCategory" />
      <short value="Hispanic or Latino|Not Hispanic or Latino" />
      <definition value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting, and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15, as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
      </type>
      <mustSupport value="true" />
      <isModifier value="false" />
      <mapping>
        <identity value="iso11179" />
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/ethnicGroupCode" />
      </mapping>
    </element>
    <element id="Extension:ethnicity.extension:ombcategory.url">
      <path value="Extension.extension.url" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="uri" />
      </type>
      <fixedUri value="ombCategory" />
    </element>
    <element id="Extension:ethnicity.extension:ombcategory.valueCoding">
      <path value="Extension.extension.valueCoding" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="Coding" />
      </type>
      <binding>
        <strength value="required" />
        <description value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting, and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15, as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)." />
        <valueSet value="http://fhirr4.kids-first.io/fhir/ValueSet/omb-ethnicity-category" />
      </binding>
    </element>
    <element id="Extension:ethnicity.extension:detailed">
      <path value="Extension.extension" />
      <sliceName value="detailed" />
      <short value="Extended ethnicity codes" />
      <definition value="The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category codes." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="Extension" />
      </type>
      <isModifier value="false" />
      <mapping>
        <identity value="iso11179" />
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode" />
      </mapping>
    </element>
    <element id="Extension:ethnicity.extension:detailed.url">
      <path value="Extension.extension.url" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="uri" />
      </type>
      <fixedUri value="detailed" />
    </element>
    <element id="Extension:ethnicity.extension:detailed.valueCoding">
      <path value="Extension.extension.valueCoding" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="Coding" />
      </type>
      <binding>
        <strength value="required" />
        <description value="The 41 [CDC ethnicity codes](http://www.cdc.gov/phin/resources/vocabulary/index.html) that are grouped under one of the 2 OMB ethnicity category codes." />
        <valueSet value="http://fhirr4.kids-first.io/fhir/ValueSet/detailed-ethnicity" />
      </binding>
    </element>
    <element id="Extension:ethnicity.extension:text">
      <path value="Extension.extension" />
      <sliceName value="text" />
      <short value="ethnicity Text" />
      <definition value="Plain text representation of the ethnicity concept(s)." />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="Extension" />
      </type>
      <mustSupport value="true" />
      <isModifier value="false" />
    </element>
    <element id="Extension:ethnicity.extension:text.url">
      <path value="Extension.extension.url" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="uri" />
      </type>
      <fixedUri value="text" />
    </element>
    <element id="Extension:ethnicity.extension:text.valueString">
      <path value="Extension.extension.valueString" />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="string" />
      </type>
    </element>
    <element id="Extension:ethnicity.url">
      <path value="Extension.url" />
      <min value="1" />
      <max value="1" />
      <fixedUri value="http://fhirr4.kids-first.io/fhir/StructureDefinition/us-core-ethnicity" />
    </element>
  </differential>
</StructureDefinition>