Huli FHIR Core Implementation Guide (R5) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Extension: Huli Ethnicity (experimental — IG-only) (Experimental)
| Official URL: https://fhir.huli.ai/r5/StructureDefinition/huli-ethnicity | Version: 0.1.0 | |||
| Draft as of 2026-09-11 | Computable Name: HuliEthnicity | |||
Ethnicity classification for Latin American healthcare contexts, aligned with Mexican NOM-024-SSA3 requirements for tracking indigenous and Afro-descendant populations.
Status — experimental and IG-only. This extension defines a
forward-compatible contract for ethnicity data. The Public API does
not emit it on Patient resources at this revision, and partner
systems should not require its presence.
Mapping shape: sourced from the patient demographics' ethnicity
sub-object. A group value maps to a display string, while the
is_indigenous and is_afromexican flags map to specific codes in
the bound value set.
Context of Use
-
Element ID:
Patient
This extension may be used on the following element(s)
Usage info
Usages:
- Use this Extension: Huli Patient
You can also check for usages in the FHIR IG Statistics
Formal Views of Extension Content
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from Extension
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  Extension |
0..* | Extension | Huli Ethnicity (experimental — IG-only) | |
  extension |
0..0 | Extension | ||
| url |
1..1 | uri | "https://fhir.huli.ai/r5/StructureDefinition/huli-ethnicity" | |
  value[x] |
1..1 | CodeableConcept | Value of extension Binding: Huli Ethnicity Value Set (extensible) | |
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..* | Extension | Huli Ethnicity (experimental — IG-only) | |
 id |
0..1 | id | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url | ||
| url |
1..1 | uri | "https://fhir.huli.ai/r5/StructureDefinition/huli-ethnicity" | |
| value[x] |
1..1 | CodeableConcept | Value of extension Binding: Huli Ethnicity Value Set (extensible) | |
| Documentation for this format | ||||
This structure is derived from Extension
Summary
Simple Extension with the type CodeableConcept: Ethnicity classification for Latin American healthcare contexts, aligned with Mexican NOM-024-SSA3 requirements for tracking indigenous and Afro-descendant populations.
Status — experimental and IG-only. This extension defines a
forward-compatible contract for ethnicity data. The Public API does
not emit it on Patient resources at this revision, and partner
systems should not require its presence.
Mapping shape: sourced from the patient demographics' ethnicity
sub-object. A group value maps to a display string, while the
is_indigenous and is_afromexican flags map to specific codes in
the bound value set.
Differential View
This structure is derived from Extension
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..* | Extension | Huli Ethnicity (experimental — IG-only) | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "https://fhir.huli.ai/r5/StructureDefinition/huli-ethnicity" | |
| value[x] |
1..1 | CodeableConcept | Value of extension Binding: Huli Ethnicity Value Set (extensible) | |
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..* | Extension | Huli Ethnicity (experimental — IG-only) | |
| id |
0..1 | id | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url | ||
| url |
1..1 | uri | "https://fhir.huli.ai/r5/StructureDefinition/huli-ethnicity" | |
| value[x] |
1..1 | CodeableConcept | Value of extension Binding: Huli Ethnicity Value Set (extensible) | |
| Documentation for this format | ||||
This structure is derived from Extension
Summary
Simple Extension with the type CodeableConcept: Ethnicity classification for Latin American healthcare contexts, aligned with Mexican NOM-024-SSA3 requirements for tracking indigenous and Afro-descendant populations.
Status — experimental and IG-only. This extension defines a
forward-compatible contract for ethnicity data. The Public API does
not emit it on Patient resources at this revision, and partner
systems should not require its presence.
Mapping shape: sourced from the patient demographics' ethnicity
sub-object. A group value maps to a display string, while the
is_indigenous and is_afromexican flags map to specific codes in
the bound value set.
Other representations of profile: CSV, Excel, Schematron
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x] | Base | extensible | Huli Ethnicity Value Set | 📦0.1.0 | This IG |
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()
|