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#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:\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:
    index: 0
    slicing:
      rules: open
      discriminator:
      - {path: url, type: value}
      min: 1
      slices:
        ombCategory:
          match: {url: ombCategory}
          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: 6
            index: 1
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: ombCategory}
                index: 2
              value:
                choices: [valueCoding]
                index: 4
              valueCoding: {type: Coding, choiceOf: value, index: 5}
            required: [valueCoding, url, value]
        detailed:
          match: {url: detailed}
          schema:
            short: Extended race codes
            type: Extension
            array: true
            index: 6
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: detailed}
                index: 7
              value:
                choices: [valueCoding]
                index: 9
              valueCoding: {type: Coding, choiceOf: value, index: 10}
            required: [valueCoding, url, value]
        text:
          match: {url: text}
          schema:
            short: Race Text
            type: Extension
            mustSupport: true
            _required: true
            index: 11
            elements:
              url:
                type: uri
                pattern: {type: Uri, value: text}
                index: 12
              value:
                choices: [valueString]
                index: 14
              valueString: {type: string, choiceOf: value, index: 15}
            required: [url, valueString, value]
  url:
    pattern: {type: Uri, value: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'}
    index: 16
  value:
    choices: []
    index: 18
package_version: 7.0.0
extensions:
  ombCategory:
    short: American Indian or Alaska Native|Asian|Black or African American|Native Hawaiian or Other Pacific Islander|White
    index: 1
    type: Extension
    mustSupport: true
    array: true
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: ombCategory}
        index: 2
      value:
        choices: [valueCoding]
        index: 4
      valueCoding: {type: Coding, choiceOf: value, index: 5}
    max: 6
    url: ombCategory
    required: [valueCoding, url, value]
  detailed:
    url: detailed
    short: Extended race codes
    type: Extension
    array: true
    index: 6
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: detailed}
        index: 7
      value:
        choices: [valueCoding]
        index: 9
      valueCoding: {type: Coding, choiceOf: value, index: 10}
    required: [valueCoding, url, value]
  text:
    url: text
    short: Race Text
    type: Extension
    mustSupport: true
    _required: true
    index: 11
    elements:
      url:
        type: uri
        pattern: {type: Uri, value: text}
        index: 12
      value:
        choices: [valueString]
        index: 14
      valueString: {type: string, choiceOf: value, index: 15}
    required: [url, valueString, value]
class: extension
kind: complex-type
url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race
base: http://hl7.org/fhir/StructureDefinition/Extension
version: 7.0.0
required: [url, extension]