description: 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) 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:\n\n - American Indian or Alaska Native\n - Asian\n - Black or African American\n - Native Hawaiian or Other Pacific Islander\n - White.
package_name: hl7.fhir.us.core
derivation: constraint
name: USCoreRaceExtension
type: Extension
elements:
  extension:
    short: American Indian or Alaska Native|Asian|Black or African American|Native Hawaiian or Other Pacific Islander|White
    type: Extension
    mustSupport: true
    array: true
    max: 5
    index: 0
    slicing:
      slices:
        ombCategory:
          match: {}
          schema:
            short: American Indian or Alaska Native|Asian|Black or African American|Native Hawaiian or Other Pacific Islander|White
            type: Extension
            mustSupport: true
            array: true
            max: 5
            index: 0
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: ombCategory}
                index: 1
              valueCoding:
                type: Coding
                binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/omb-race-category'}
                index: 2
            required: [valueCoding, url]
        detailed:
          match: {}
          schema:
            short: Extended race codes
            type: Extension
            array: true
            index: 3
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: detailed}
                index: 4
              valueCoding:
                type: Coding
                binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/detailed-race'}
                index: 5
            required: [valueCoding, url]
        text:
          match: {}
          schema:
            short: Race Text
            type: Extension
            mustSupport: true
            _required: true
            index: 6
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: text}
                index: 7
              valueString: {type: string, index: 8}
            required: [url, valueString]
  url:
    pattern: {type: Uri, value: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'}
    index: 9
  value:
    choices: []
    index: 11
package_version: 3.1.0
extensions:
  ombCategory:
    short: American Indian or Alaska Native|Asian|Black or African American|Native Hawaiian or Other Pacific Islander|White
    index: 0
    type: Extension
    mustSupport: true
    array: true
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: ombCategory}
        index: 1
      valueCoding:
        type: Coding
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/omb-race-category'}
        index: 2
    max: 5
    url: null
    required: [valueCoding, url]
  detailed:
    url: null
    short: Extended race codes
    type: Extension
    array: true
    index: 3
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: detailed}
        index: 4
      valueCoding:
        type: Coding
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/detailed-race'}
        index: 5
    required: [valueCoding, url]
  text:
    url: null
    short: Race Text
    type: Extension
    mustSupport: true
    _required: true
    index: 6
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: text}
        index: 7
      valueString: {type: string, index: 8}
    required: [url, valueString]
class: extension
kind: complex-type
url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race
base: http://hl7.org/fhir/StructureDefinition/Extension
version: 3.1.0
required: [url]