US Core Implementation Guide
9.0.0 - STU 9 US

US Core Implementation Guide - Downloaded Version 9.0.0 See the Directory of published versions

## Extension: US Core Ethnicity Extension

Official URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | Version: 9.0.0
Standards status: Trial-use | Maturity Level: 5 | Computable Name: USCoreEthnicityExtension
Other Identifiers: OID:2.16.840.1.113883.4.642.40.2.42.25

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 Race & Ethnicity - CDC (CDCREC) code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories:

- Hispanic or Latino
- Not Hispanic or Latino.

Complies with 2015 Edition Common Clinical Data Set for patient race.

Context of Use

This extension may be used on the following element(s)

- Element ID: `Patient`
- Element ID: `RelatedPerson`
- Element ID: `Person`
- Element ID: `Practitioner`
- Element ID: `FamilyMemberHistory`

### Profile specific implementation guidance

- This Complex Extension for ethnicity allows one or more ethnicity codes of which:

  - Must Support one code from OMB Ethnicity Categories
  - May include additional ethnicity codes from CDC Ethnicity Codes
  - Must include a text description of ethnicity

- An [`ethnicity`] search parameter has been defined for this extension. However, there are no ethnicity search requirements for the Client or Server.

Usage info

Usages:

- Use this Extension: US Core Patient Profile
- Examples for this Extension: Patient/child-example, Patient/deceased-example, Patient/example and Patient/infant-example

You can also check for usages in the FHIR IG Statistics

Changes since version 8.0.1:

- The resource metadata has changed (description, copyright)
- The data elements list has changed
- One or more text definitions, invariants or bindings have changed

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Differential Table
- Snapshot Table
- Statistics/References
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | US Core ethnicity Extension
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:ombCategory | S | 0..1 | Extension | Hispanic or Latino|Not Hispanic or Latino
url |  | 1..1 | uri | "ombCategory"
value[x] |  | 1..1 | Coding | Value of extension Binding: Ethnicity Categories (required)
extension:detailed |  | 0..* | Extension | Extended ethnicity codes
url |  | 1..1 | uri | "detailed"
value[x] |  | 1..1 | Coding | Value of extension Binding: Detailed Ethnicity Including Absence Reasons (required)
extension:text | S | 1..1 | Extension | ethnicity Text
url |  | 1..1 | uri | "text"
value[x] |  | 1..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | US Core ethnicity Extension
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:ombCategory | S | 0..1 | Extension | Hispanic or Latino|Not Hispanic or Latino
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "ombCategory"
value[x] |  | 1..1 | Coding | Value of extension Binding: Ethnicity Categories (required)
extension:detailed |  | 0..* | Extension | Extended ethnicity codes
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "detailed"
value[x] |  | 1..1 | Coding | Value of extension Binding: Detailed Ethnicity Including Absence Reasons (required)
extension:text | S | 1..1 | Extension | ethnicity Text
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "text"
value[x] |  | 1..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: 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 Race & Ethnicity - CDC (CDCREC) code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories:

- Hispanic or Latino
- Not Hispanic or Latino.

- ombCategory: Coding: 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.
- detailed: Coding: The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category codes.
- text: string: Plain text representation of the ethnicity concept(s).

Maturity: 5

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | US Core ethnicity Extension
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:ombCategory | S | 0..1 | Extension | Hispanic or Latino|Not Hispanic or Latino
url |  | 1..1 | uri | "ombCategory"
value[x] |  | 1..1 | Coding | Value of extension Binding: Ethnicity Categories (required)
extension:detailed |  | 0..* | Extension | Extended ethnicity codes
url |  | 1..1 | uri | "detailed"
value[x] |  | 1..1 | Coding | Value of extension Binding: Detailed Ethnicity Including Absence Reasons (required)
extension:text | S | 1..1 | Extension | ethnicity Text
url |  | 1..1 | uri | "text"
value[x] |  | 1..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | US Core ethnicity Extension
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:ombCategory | S | 0..1 | Extension | Hispanic or Latino|Not Hispanic or Latino
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "ombCategory"
value[x] |  | 1..1 | Coding | Value of extension Binding: Ethnicity Categories (required)
extension:detailed |  | 0..* | Extension | Extended ethnicity codes
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "detailed"
value[x] |  | 1..1 | Coding | Value of extension Binding: Detailed Ethnicity Including Absence Reasons (required)
extension:text | S | 1..1 | Extension | ethnicity Text
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "text"
value[x] |  | 1..1 | string | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: 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 Race & Ethnicity - CDC (CDCREC) code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories:

- Hispanic or Latino
- Not Hispanic or Latino.

- ombCategory: Coding: 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.
- detailed: Coding: The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category codes.
- text: string: Plain text representation of the ethnicity concept(s).

Maturity: 5

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.extension:ombCategory.​value[x] | Base | required | Ethnicity Categories | ⏿20250419 | tx.fhir.org
Extension.extension:detailed.​value[x] | Base | required | Detailed Ethnicity Including Absence Reasons | ⏿20250419 | tx.fhir.org

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`