{
"description": "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:\\r- Hispanic or Latino\\r- Not Hispanic or Latino.",
"_filename": "extension-us-core-ethnicity.json",
"package_name": "hl7.fhir.core",
"date": "2013-12-03",
"derivation": "constraint",
"publisher": "Health Level Seven International (US Realm Steering Committee)",
"fhirVersion": "1.8.0",
"name": "US Core ethnicity Extension",
"mapping": [ {
"uri": "http://hl7.org/v3/cda",
"name": "CDA (R2)",
"identity": "cda"
}, {
"uri": "http://hl7.org/v3",
"name": "RIM Mapping",
"identity": "rim"
} ],
"abstract": false,
"type": "Extension",
"experimental": null,
"resourceType": "StructureDefinition",
"title": "US Core ethnicity Extension",
"package_version": "1.8.0",
"snapshot": {
"element": [ {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "Element",
"severity": "error",
"expression": "children().count() > id.count()"
}, {
"key": "ext-1",
"human": "Must have either extensions or value[x], not both",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
"source": "Extension",
"severity": "error",
"expression": "extension.exists() != value.exists()"
} ],
"path": "Extension",
"min": 0,
"definition": "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:\r- Hispanic or Latino\r- Not Hispanic or Latino.",
"short": "US Core ethnicity Extension",
"max": "1",
"id": "Extension:uscoreethnicityextension",
"condition": [ "ele-1" ],
"base": {
"max": "*",
"min": 0,
"path": "Extension"
}
}, {
"path": "Extension.id",
"min": 0,
"definition": "unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"short": "xml:id (or equivalent in JSON)",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "string"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.id",
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
}
}, {
"path": "Extension.extension",
"min": 0,
"definition": "An Extension",
"short": "Extension",
"slicing": {
"id": "76",
"rules": "open",
"ordered": false,
"discriminator": [ "url" ]
},
"type": [ {
"code": "Extension"
} ],
"max": "*",
"id": "Extension:uscoreethnicityextension.extension",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension",
"min": 1,
"definition": "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).",
"short": "Hispanic or Latino|Not Hispanic or Latino",
"mapping": [ {
"map": "/ClinicalDocument/recordTarget/patientRole/patient/ethnicGroupCode",
"identity": "cda"
} ],
"type": [ {
"code": "Extension"
} ],
"sliceName": "ombCategory",
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:ombcategory",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.id",
"min": 0,
"definition": "unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"short": "xml:id (or equivalent in JSON)",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "string"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:ombcategory.id",
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
}
}, {
"path": "Extension.extension.extension",
"min": 0,
"definition": "An Extension",
"short": "Extension",
"type": [ {
"code": "Extension"
} ],
"sliceName": "extension",
"max": "0",
"id": "Extension:uscoreethnicityextension.extension:ombcategory.extension:extension",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.url",
"min": 1,
"definition": "Source of the definition for the extension code - a logical name or a URL.",
"short": "identifies the meaning of the extension",
"fixedUri": "ombCategory",
"comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "uri"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:ombcategory.url",
"base": {
"max": "1",
"min": 1,
"path": "Extension.url"
}
}, {
"path": "Extension.extension.valueCoding",
"min": 1,
"definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).",
"short": "Value of extension",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "Coding"
} ],
"binding": {
"strength": "required",
"description": "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).",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/omb-ethnicity"
}
},
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:ombcategory.valueCoding",
"base": {
"max": "1",
"min": 0,
"path": "Extension.value[x]"
}
}, {
"path": "Extension.extension",
"min": 0,
"definition": "The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category codes.",
"short": "Extended ethnicity codes",
"mapping": [ {
"map": "/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode",
"identity": "cda"
} ],
"type": [ {
"code": "Extension"
} ],
"sliceName": "detailed",
"max": "*",
"id": "Extension:uscoreethnicityextension.extension:detailed",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.id",
"min": 0,
"definition": "unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"short": "xml:id (or equivalent in JSON)",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "string"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:detailed.id",
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
}
}, {
"path": "Extension.extension.extension",
"min": 0,
"definition": "An Extension",
"short": "Extension",
"type": [ {
"code": "Extension"
} ],
"sliceName": "extension",
"max": "0",
"id": "Extension:uscoreethnicityextension.extension:detailed.extension:extension",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.url",
"min": 1,
"definition": "Source of the definition for the extension code - a logical name or a URL.",
"short": "identifies the meaning of the extension",
"fixedUri": "detailed",
"comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "uri"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:detailed.url",
"base": {
"max": "1",
"min": 1,
"path": "Extension.url"
}
}, {
"path": "Extension.extension.valueCoding",
"min": 1,
"definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).",
"short": "Value of extension",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "Coding"
} ],
"binding": {
"strength": "required",
"description": "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.",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/detailed-ethnicity"
}
},
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:detailed.valueCoding",
"base": {
"max": "1",
"min": 0,
"path": "Extension.value[x]"
}
}, {
"path": "Extension.extension",
"min": 0,
"definition": "Plain text representation of the ethnicity concept(s).",
"short": "ethnicity Text",
"type": [ {
"code": "Extension"
} ],
"sliceName": "text",
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:text",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.id",
"min": 0,
"definition": "unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"short": "xml:id (or equivalent in JSON)",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "string"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:text.id",
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
}
}, {
"path": "Extension.extension.extension",
"min": 0,
"definition": "An Extension",
"short": "Extension",
"type": [ {
"code": "Extension"
} ],
"sliceName": "extension",
"max": "0",
"id": "Extension:uscoreethnicityextension.extension:text.extension:extension",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
}
}, {
"path": "Extension.extension.url",
"min": 1,
"definition": "Source of the definition for the extension code - a logical name or a URL.",
"short": "identifies the meaning of the extension",
"fixedUri": "text",
"comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "uri"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:text.url",
"base": {
"max": "1",
"min": 1,
"path": "Extension.url"
}
}, {
"path": "Extension.extension.valueString",
"min": 1,
"definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).",
"short": "Value of extension",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "string"
} ],
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:text.valueString",
"base": {
"max": "1",
"min": 0,
"path": "Extension.value[x]"
}
}, {
"path": "Extension.url",
"min": 1,
"definition": "Source of the definition for the extension code - a logical name or a URL.",
"short": "identifies the meaning of the extension",
"fixedUri": "http://hl7.org/fhir/StructureDefinition/us-core-ethnicity",
"comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "uri"
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Extension:uscoreethnicityextension.url",
"base": {
"max": "1",
"min": 1,
"path": "Extension.url"
}
}, {
"path": "Extension.value[x]",
"min": 0,
"definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).",
"short": "Value of extension",
"mapping": [ {
"map": "N/A",
"identity": "rim"
} ],
"type": [ {
"code": "base64Binary"
}, {
"code": "boolean"
}, {
"code": "code"
}, {
"code": "date"
}, {
"code": "dateTime"
}, {
"code": "decimal"
}, {
"code": "id"
}, {
"code": "instant"
}, {
"code": "integer"
}, {
"code": "markdown"
}, {
"code": "oid"
}, {
"code": "positiveInt"
}, {
"code": "string"
}, {
"code": "time"
}, {
"code": "unsignedInt"
}, {
"code": "uri"
}, {
"code": "Address"
}, {
"code": "Age"
}, {
"code": "Annotation"
}, {
"code": "Attachment"
}, {
"code": "CodeableConcept"
}, {
"code": "Coding"
}, {
"code": "ContactPoint"
}, {
"code": "Count"
}, {
"code": "Distance"
}, {
"code": "Duration"
}, {
"code": "HumanName"
}, {
"code": "Identifier"
}, {
"code": "Money"
}, {
"code": "Period"
}, {
"code": "Quantity"
}, {
"code": "Range"
}, {
"code": "Ratio"
}, {
"code": "Reference"
}, {
"code": "SampledData"
}, {
"code": "Signature"
}, {
"code": "Timing"
}, {
"code": "Meta"
} ],
"max": "0",
"id": "Extension:uscoreethnicityextension.value[x]",
"base": {
"max": "1",
"min": 0,
"path": "Extension.value[x]"
}
} ]
},
"status": "draft",
"id": "bc555816-5263-49bf-acc0-9af5b9bbb383",
"kind": "complex-type",
"url": "http://hl7.org/fhir/StructureDefinition/us-core-ethnicity",
"context": [ "Patient" ],
"version": null,
"differential": {
"element": [ {
"id": "Extension:uscoreethnicityextension",
"max": "1",
"min": 0,
"path": "Extension",
"short": "US Core ethnicity Extension",
"definition": "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:\r- Hispanic or Latino\r- Not Hispanic or Latino."
}, {
"path": "Extension.extension",
"min": 1,
"definition": "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).",
"short": "Hispanic or Latino|Not Hispanic or Latino",
"mapping": [ {
"map": "/ClinicalDocument/recordTarget/patientRole/patient/ethnicGroupCode",
"identity": "cda"
} ],
"type": [ {
"code": "Extension"
} ],
"sliceName": "ombCategory",
"max": "1",
"id": "Extension:uscoreethnicityextension.extension:ombcategory"
}, {
"id": "Extension:uscoreethnicityextension.extension:ombcategory.extension:extension",
"max": "0",
"path": "Extension.extension.extension",
"sliceName": "extension"
}, {
"id": "Extension:uscoreethnicityextension.extension:ombcategory.url",
"path": "Extension.extension.url",
"type": [ {
"code": "uri"
} ],
"fixedUri": "ombCategory"
}, {
"id": "Extension:uscoreethnicityextension.extension:ombcategory.value[x]",
"min": 1,
"path": "Extension.extension.value[x]",
"type": [ {
"code": "Coding"
} ],
"binding": {
"strength": "required",
"description": "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).",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/omb-ethnicity"
}
}
}, {
"path": "Extension.extension",
"min": 0,
"definition": "The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category codes.",
"short": "Extended ethnicity codes",
"mapping": [ {
"map": "/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode",
"identity": "cda"
} ],
"type": [ {
"code": "Extension"
} ],
"sliceName": "detailed",
"max": "*",
"id": "Extension:uscoreethnicityextension.extension:detailed"
}, {
"id": "Extension:uscoreethnicityextension.extension:detailed.extension:extension",
"max": "0",
"path": "Extension.extension.extension",
"sliceName": "extension"
}, {
"id": "Extension:uscoreethnicityextension.extension:detailed.url",
"path": "Extension.extension.url",
"type": [ {
"code": "uri"
} ],
"fixedUri": "detailed"
}, {
"id": "Extension:uscoreethnicityextension.extension:detailed.value[x]",
"min": 1,
"path": "Extension.extension.value[x]",
"type": [ {
"code": "Coding"
} ],
"binding": {
"strength": "required",
"description": "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.",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/detailed-ethnicity"
}
}
}, {
"id": "Extension:uscoreethnicityextension.extension:text",
"max": "1",
"min": 0,
"path": "Extension.extension",
"type": [ {
"code": "Extension"
} ],
"short": "ethnicity Text",
"sliceName": "text",
"definition": "Plain text representation of the ethnicity concept(s)."
}, {
"id": "Extension:uscoreethnicityextension.extension:text.extension:extension",
"max": "0",
"path": "Extension.extension.extension",
"sliceName": "extension"
}, {
"id": "Extension:uscoreethnicityextension.extension:text.url",
"path": "Extension.extension.url",
"type": [ {
"code": "uri"
} ],
"fixedUri": "text"
}, {
"id": "Extension:uscoreethnicityextension.extension:text.value[x]",
"min": 1,
"path": "Extension.extension.value[x]",
"type": [ {
"code": "string"
} ]
}, {
"id": "Extension:uscoreethnicityextension.url",
"path": "Extension.url",
"type": [ {
"code": "uri"
} ],
"fixedUri": "http://hl7.org/fhir/StructureDefinition/us-core-ethnicity"
}, {
"id": "Extension:uscoreethnicityextension.value[x]",
"max": "0",
"min": 0,
"path": "Extension.value[x]"
} ]
},
"contact": [ {
"telecom": [ {
"value": "http://www.hl7.org/Special/Committees/usrealm",
"system": "url"
} ]
} ],
"contextType": "resource",
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/Extension"
}