# US Core Patient Profile - Health eData 1 Sandbox v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **US Core Patient Profile**

## Resource Profile: US Core Patient Profile 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | *Version*:0.1.0 | |
| Active as of 2026-05-14 | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 5 | *Computable Name*:USCorePatientProfile |
| *Other Identifiers:*OID:2.16.840.1.113883.4.642.40.2.42.50 | | |

 
The US Core Patient Profile inherits from the FHIR [Patient](https://hl7.org/fhir/R4/patient.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the [U.S. Core Data for Interoperability (USCDI)](https://www.healthit.gov/isp/united-states-core-data-interoperability-uscdi) **Patient Demographics/Information** Data Class. It sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption. 

**Example Usage Scenarios:**

The following are example usage scenarios for the US Core Patient profile:

* Query for Patient resources belonging to a Patient
* [Record or update] a Patient Patient

### Mandatory and Must Support Data Elements

The following data elements must always be present ([Mandatory] definition) or must be supported if the data is present in the sending system ([Must Support] definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The [Formal Views] below provides the formal summary, definitions, and terminology requirements.

**Each Patient Must Have:**

1. an identifier for this patient
1. the namespace for the identifier value
1. the value that is unique within the system
1. a name associated with the patient
1. a system
1. the actual contact point details
1. the language which can be used to communicate with the patient about his or her health

**Each Patient Must Support:**

1. family name (often called 'Surname')
1. given names (not always 'first'). Includes middle names
1. 

| | | | | |
| :--- | :--- | :--- | :--- | :--- |
| home | work | temp | old | mobile - purpose of this contact point |


1. the date of birth for the individual
1. an address for the individual
1. street name, number, direction & P.O. Box etc
1. name of city, town etc
1. sub-unit of country (abbreviations ok)
1. uS Zip Codes
1. the kind of relationship
1. a name associated with the contact person
1. a contact detail for the person

**Additional USCDI Requirements:**

These [Additional USCDI Requirements] elements are not Mandatory or Must Support but are required for ONC Health IT certification testing and are included in the formal definition of the profile and the Patient examples.

1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension)
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension)
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter
1. 

| | | | | | | |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden |


1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not
1. 

| | | | | |
| :--- | :--- | :--- | :--- | :--- |
| 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address |


1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient
1. 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health

### Profile Specific Implementation Guidance

This section provides detailed implementation guidance for the US Core Profile to support implementation and certification.

### Liquid Script to Generate StructureDefinition All Nice N Pretty Like

{% include structure-table.md sd=sd source="differential" show_must_support=true show_uscdi=true %}

## USCorePatientProfile — US Core Patient Profile

The US Core Patient Profile inherits from the FHIR [Patient](https://hl7.org/fhir/R4/patient.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the [U.S. Core Data for Interoperability (USCDI)](https://www.healthit.gov/isp/united-states-core-data-interoperability-uscdi) **Patient Demographics/Information** Data Class. It sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

* **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`
* **Version:** 0.1.0
* **Status:** active
* **Kind:** resource
* **Type:** `Patient`
* **Base Definition:** `http://hl7.org/fhir/StructureDefinition/Patient`
* **Derivation:** constraint

### Elements (differential)

| | | | | | |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `Patient` |   |   | 0..* |   | **Information about an individual or animal receiving health care services**Demographics and other administrative information about an individual or animal receiving care or other health-related services. |
| ↳`extension`slice: `race` |   | ✅ | 0..1 | `Extension`profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race | **US Core Race Extension. (multiple races are supported in the extension)**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[Race & Ethnicity - CDC (CDCREC)](https://phinvads.cdc.gov/vads/ViewCodeSystem.action?id=2.16.840.1.113883.6.238)code system. Detailed race concepts are grouped by and pre-mapped to the 5 OMB race categories: - American Indian or Alaska Native - Asian - Black or African American - Native Hawaiian or Other Pacific Islander - White. |
| ↳`extension`slice: `ethnicity` |   | ✅ | 0..1 | `Extension`profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | **US Core ethnicity Extension (multiple ethnicities are supported in the 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)](https://phinvads.cdc.gov/vads/ViewCodeSystem.action?id=2.16.840.1.113883.6.238)code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino. |
| ↳`extension`slice: `tribalAffiliation` |   | ✅ | 0..* | `Extension`profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | **Tribal Affiliation Extension**A tribe or band with which a person associates whether or not they are an enrolled member. |
| ↳`extension`slice: `sex` |   | ✅ | 0..1 | `Extension`profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex | **Sex Extension**The US Core Individual Sex Extension is used to reflect the documentation of a person's sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0). |
| ↳`extension`slice: `interpreterRequired` |   | ✅ | 0..1 | `Extension`profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed | **Whether the patient needs an interpreter**This individual needs an interpreter to communicate healthcare information. |
| ↳`identifier` | ✅ |   | 1..* | `Identifier` | **An identifier for this patient**An identifier for this patient. |
| ↳`system` | ✅ |   | 1..1 | `uri` | **The namespace for the identifier value**Establishes the namespace for the value - that is, a URL that describes a set values that are unique. |
| ↳`value` | ✅ |   | 1..1 | `string` | **The value that is unique within the system.**The portion of the identifier typically relevant to the user and which is unique within the context of the system. |
| ↳`name` | ✅ |   | 1..* | `HumanName` | **A name associated with the patient**A name associated with the individual. |
| ↳`use` |   | ✅ | 0..1 | `code` | **usual | official | temp | nickname | anonymous | old | maiden**Identifies the purpose for this name.**Binding:** `http://hl7.org/fhir/ValueSet/name-use\|4.0.1` (required) — The use of a human name. |
| ↳`family` | ✅ |   | 0..1 | `string` | **Family name (often called 'Surname')**The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father. |
| ↳`given` | ✅ |   | 0..* | `string` | **Given names (not always 'first'). Includes middle names**Given name. |
| ↳`suffix` |   | ✅ | 0..* | `string` | **Parts that come after the name**Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name. |
| ↳`period` |   | ✅ | 0..1 | `Period` | **Time period when name was/is in use**Indicates the period of time when this name was valid for the named person. |
| ↳`telecom` |   | ✅ | 0..* | `ContactPoint` | **A contact detail for the individual**A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted. |
| ↳`system` | ✅ |   | 1..1 | `code` | **phone | fax | email | pager | url | sms | other**Telecommunications form for contact point - what communications system is required to make use of the contact.**Binding:** `http://hl7.org/fhir/ValueSet/contact-point-system` (required) — Telecommunications form for contact point. |
| ↳`value` | ✅ |   | 1..1 | `string` | **The actual contact point details**The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address). |
| ↳`use` | ✅ |   | 0..1 | `code` | **home | work | temp | old | mobile - purpose of this contact point**Identifies the purpose for the contact point.**Binding:** `http://hl7.org/fhir/ValueSet/contact-point-use` (required) |
| ↳`birthDate` | ✅ |   | 0..1 | `date` | **The date of birth for the individual**The date of birth for the individual. |
| ↳`deceased[x]` |   | ✅ | 0..1 | `boolean``dateTime` | **Indicates if the individual is deceased or not**Indicates if the individual is deceased or not. |
| ↳`address` | ✅ |   | 0..* | `Address` | **An address for the individual**An address for the individual. |
| ↳`use` |   | ✅ | 0..1 | `code` | **home | work | temp | old | billing - purpose of this address**The purpose of this address.**Binding:** `http://hl7.org/fhir/ValueSet/address-use\|4.0.1` (required) — The use of an address. |
| ↳`line` | ✅ |   | 0..* | `string` | **Street name, number, direction & P.O. Box etc.**This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information. |
| ↳`city` | ✅ |   | 0..1 | `string` | **Name of city, town etc.**The name of the city, town, suburb, village or other community or delivery center. |
| ↳`state` | ✅ |   | 0..1 | `string` | **Sub-unit of country (abbreviations ok)**Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).**Binding:** `http://terminology.hl7.org/ValueSet/USPS-State` (extensible) — Two Letter USPS alphabetic codes. |
| ↳`postalCode` | ✅ |   | 0..1 | `string` | **US Zip Codes**A postal code designating a region defined by the postal service. |
| ↳`period` |   | ✅ | 0..1 | `Period` | **Time period when address was/is in use**Time period when address was/is in use. |
| ↳`contact` |   | ✅ | 0..* | `BackboneElement` | **A contact party (e.g., guardian, healthcare agent, friend) for the patient**A contact party (e.g. guardian, partner, friend) for the patient. |
| ↳`relationship` | ✅ |   | 0..* | `CodeableConcept` | **The kind of relationship**The nature of the relationship between the patient and the contact person.**Binding:** `http://hl7.org/fhir/us/core/ValueSet/us-core-patient-contact-relationship` (extensible) |
| ↳`name` | ✅ |   | 0..1 | `HumanName` | **A name associated with the contact person**A name associated with the contact person. |
| ↳`telecom` | ✅ |   | 0..* | `ContactPoint` | **A contact detail for the person**A contact detail for the person, e.g. a telephone number or an email address. |
| ↳`communication` |   | ✅ | 0..* | `BackboneElement` | **A language which may be used to communicate with the patient about his or her health**A language which may be used to communicate with the patient about his or her health. |
| ↳`language` | ✅ |   | 1..1 | `CodeableConcept` | **The language which can be used to communicate with the patient about his or her health**The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English.**Binding:** `http://terminology.hl7.org/ValueSet/Languages` (extensible) |

```


## USCorePatientProfile — US Core Patient Profile

The US Core Patient Profile inherits from the FHIR [Patient](https://hl7.org/fhir/R4/patient.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the [U.S. Core Data for Interoperability (USCDI)](https://www.healthit.gov/isp/united-states-core-data-interoperability-uscdi) *Patient Demographics/Information* Data Class. It sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.

- **URL:** `http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient`
- **Version:** 0.1.0
- **Status:** active
- **Kind:** resource
- **Type:** `Patient`
- **Base Definition:** `http://hl7.org/fhir/StructureDefinition/Patient`
- **Derivation:** constraint


### Elements (differential)

| Element | Must Support | Add'l USCDI | Cardinality | Type | Description |
|---|:---:|:---:|---|---|---|
| `Patient` |  |  | 0..* |  | **Information about an individual or animal receiving health care services**<br/>Demographics and other administrative information about an individual or animal receiving care or other health-related services. |
| <span style="padding-left: 1.5em;">↳</span> `extension`<br/><span style="font-size: 0.85em;">slice: `race`</span> |  | ✅ | 0..1 | `Extension`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race</span> | **US Core Race Extension. (multiple races are supported in the extension)**<br/>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 [Race & Ethnicity - CDC (CDCREC)](https://phinvads.cdc.gov/vads/ViewCodeSystem.action?id=2.16.840.1.113883.6.238) code system. Detailed race concepts are grouped by and pre-mapped to the 5 OMB race categories:   - American Indian or Alaska Native   - Asian   - Black or African American   - Native Hawaiian or Other Pacific Islander   - White. |
| <span style="padding-left: 1.5em;">↳</span> `extension`<br/><span style="font-size: 0.85em;">slice: `ethnicity`</span> |  | ✅ | 0..1 | `Extension`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity</span> | **US Core ethnicity Extension (multiple ethnicities are supported in the extension)**<br/>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)](https://phinvads.cdc.gov/vads/ViewCodeSystem.action?id=2.16.840.1.113883.6.238) code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories:   - Hispanic or Latino   - Not Hispanic or Latino. |
| <span style="padding-left: 1.5em;">↳</span> `extension`<br/><span style="font-size: 0.85em;">slice: `tribalAffiliation`</span> |  | ✅ | 0..* | `Extension`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation</span> | **Tribal Affiliation Extension**<br/>A tribe or band with which a person associates whether or not they are an enrolled member. |
| <span style="padding-left: 1.5em;">↳</span> `extension`<br/><span style="font-size: 0.85em;">slice: `sex`</span> |  | ✅ | 0..1 | `Extension`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex</span> | **Sex Extension**<br/>The US Core Individual Sex Extension is used to reflect the documentation of a person's sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0). |
| <span style="padding-left: 1.5em;">↳</span> `extension`<br/><span style="font-size: 0.85em;">slice: `interpreterRequired`</span> |  | ✅ | 0..1 | `Extension`<br/><span style="font-size: 0.85em;">profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed</span> | **Whether the patient needs an interpreter**<br/>This individual needs an interpreter to communicate healthcare information. |
| <span style="padding-left: 1.5em;">↳</span> `identifier` | ✅ |  | 1..* | `Identifier` | **An identifier for this patient**<br/>An identifier for this patient. |
| <span style="padding-left: 3.0em;">↳</span> `system` | ✅ |  | 1..1 | `uri` | **The namespace for the identifier value**<br/>Establishes the namespace for the value - that is, a URL that describes a set values that are unique. |
| <span style="padding-left: 3.0em;">↳</span> `value` | ✅ |  | 1..1 | `string` | **The value that is unique within the system.**<br/>The portion of the identifier typically relevant to the user and which is unique within the context of the system. |
| <span style="padding-left: 1.5em;">↳</span> `name` | ✅ |  | 1..* | `HumanName` | **A name associated with the patient**<br/>A name associated with the individual. |
| <span style="padding-left: 3.0em;">↳</span> `use` |  | ✅ | 0..1 | `code` | **usual \| official \| temp \| nickname \| anonymous \| old \| maiden**<br/>Identifies the purpose for this name.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/name-use\|4.0.1` (required) — The use of a human name.</span> |
| <span style="padding-left: 3.0em;">↳</span> `family` | ✅ |  | 0..1 | `string` | **Family name (often called 'Surname')**<br/>The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father. |
| <span style="padding-left: 3.0em;">↳</span> `given` | ✅ |  | 0..* | `string` | **Given names (not always 'first'). Includes middle names**<br/>Given name. |
| <span style="padding-left: 3.0em;">↳</span> `suffix` |  | ✅ | 0..* | `string` | **Parts that come after the name**<br/>Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name. |
| <span style="padding-left: 3.0em;">↳</span> `period` |  | ✅ | 0..1 | `Period` | **Time period when name was/is in use**<br/>Indicates the period of time when this name was valid for the named person. |
| <span style="padding-left: 1.5em;">↳</span> `telecom` |  | ✅ | 0..* | `ContactPoint` | **A contact detail for the individual**<br/>A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted. |
| <span style="padding-left: 3.0em;">↳</span> `system` | ✅ |  | 1..1 | `code` | **phone \| fax \| email \| pager \| url \| sms \| other**<br/>Telecommunications form for contact point - what communications system is required to make use of the contact.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/contact-point-system` (required) — Telecommunications form for contact point.</span> |
| <span style="padding-left: 3.0em;">↳</span> `value` | ✅ |  | 1..1 | `string` | **The actual contact point details**<br/>The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address). |
| <span style="padding-left: 3.0em;">↳</span> `use` | ✅ |  | 0..1 | `code` | **home \| work \| temp \| old \| mobile - purpose of this contact point**<br/>Identifies the purpose for the contact point.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/contact-point-use` (required)</span> |
| <span style="padding-left: 1.5em;">↳</span> `birthDate` | ✅ |  | 0..1 | `date` | **The date of birth for the individual**<br/>The date of birth for the individual. |
| <span style="padding-left: 1.5em;">↳</span> `deceased[x]` |  | ✅ | 0..1 | `boolean`<br/>`dateTime` | **Indicates if the individual is deceased or not**<br/>Indicates if the individual is deceased or not. |
| <span style="padding-left: 1.5em;">↳</span> `address` | ✅ |  | 0..* | `Address` | **An address for the individual**<br/>An address for the individual. |
| <span style="padding-left: 3.0em;">↳</span> `use` |  | ✅ | 0..1 | `code` | **home \| work \| temp \| old \| billing - purpose of this address**<br/>The purpose of this address.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/ValueSet/address-use\|4.0.1` (required) — The use of an address.</span> |
| <span style="padding-left: 3.0em;">↳</span> `line` | ✅ |  | 0..* | `string` | **Street name, number, direction & P.O. Box etc.**<br/>This component contains the house number, apartment number, street name, street direction,  P.O. Box number, delivery hints, and similar address information. |
| <span style="padding-left: 3.0em;">↳</span> `city` | ✅ |  | 0..1 | `string` | **Name of city, town etc.**<br/>The name of the city, town, suburb, village or other community or delivery center. |
| <span style="padding-left: 3.0em;">↳</span> `state` | ✅ |  | 0..1 | `string` | **Sub-unit of country (abbreviations ok)**<br/>Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).<br/><span style="font-size: 0.85em;">**Binding:** `http://terminology.hl7.org/ValueSet/USPS-State` (extensible) — Two Letter USPS alphabetic codes.</span> |
| <span style="padding-left: 3.0em;">↳</span> `postalCode` | ✅ |  | 0..1 | `string` | **US Zip Codes**<br/>A postal code designating a region defined by the postal service. |
| <span style="padding-left: 3.0em;">↳</span> `period` |  | ✅ | 0..1 | `Period` | **Time period when address was/is in use**<br/>Time period when address was/is in use. |
| <span style="padding-left: 1.5em;">↳</span> `contact` |  | ✅ | 0..* | `BackboneElement` | **A contact party (e.g., guardian, healthcare agent, friend) for the patient**<br/>A contact party (e.g. guardian, partner, friend) for the patient. |
| <span style="padding-left: 3.0em;">↳</span> `relationship` | ✅ |  | 0..* | `CodeableConcept` | **The kind of relationship**<br/>The nature of the relationship between the patient and the contact person.<br/><span style="font-size: 0.85em;">**Binding:** `http://hl7.org/fhir/us/core/ValueSet/us-core-patient-contact-relationship` (extensible)</span> |
| <span style="padding-left: 3.0em;">↳</span> `name` | ✅ |  | 0..1 | `HumanName` | **A name associated with the contact person**<br/>A name associated with the contact person. |
| <span style="padding-left: 3.0em;">↳</span> `telecom` | ✅ |  | 0..* | `ContactPoint` | **A contact detail for the person**<br/>A contact detail for the person, e.g. a telephone number or an email address. |
| <span style="padding-left: 1.5em;">↳</span> `communication` |  | ✅ | 0..* | `BackboneElement` | **A language which may be used to communicate with the patient about his or her health**<br/>A language which may be used to communicate with the patient about his or her health. |
| <span style="padding-left: 3.0em;">↳</span> `language` | ✅ |  | 1..1 | `CodeableConcept` | **The language which can be used to communicate with the patient about his or her health**<br/>The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English.<br/><span style="font-size: 0.85em;">**Binding:** `http://terminology.hl7.org/ValueSet/Languages` (extensible)</span> |





```

**Usages:**

* Refer to this Profile: [US Core AllergyIntolerance Profile](StructureDefinition-us-core-allergyintolerance.md), [US Core Appointment Profile](StructureDefinition-us-core-appointment.md), [US Core DeviceRequest Profile](StructureDefinition-us-core-devicerequest.md), [US Core Flag Profile](StructureDefinition-us-core-flag.md)... Show 42 more, [US Core MedicationAdministration Profile](StructureDefinition-us-core-medicationadministration.md), [US Core Nutrition Order Profile](StructureDefinition-us-core-nutritionorder.md), [US Core Observation Patient Accommodation Profile](StructureDefinition-us-core-observation-accommodation.md), [US Core Specimen Profile](StructureDefinition-us-core-specimen.md), [US Core ADI DocumentReference Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-adi-documentreference.html), [US Core AllergyIntolerance Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-allergyintolerance.html), [US Core Average Blood Pressure Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-average-blood-pressure.html), [US Core Care Experience Preference Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-care-experience-preference.html), [US Core CarePlan Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-careplan.html), [US Core CareTeam Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-careteam.html), [US Core Condition Encounter Diagnosis Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-condition-encounter-diagnosis.html), [US Core Condition Problems and Health Concerns Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-condition-problems-health-concerns.html), [US Core Coverage Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-coverage.html), [US Core Device Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-device.html), [US Core DiagnosticReport Profile for Laboratory Results Reporting](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-diagnosticreport-lab.html), [US Core DiagnosticReport Profile for Report and Note Exchange](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-diagnosticreport-note.html), [US Core DocumentReference Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-documentreference.html), [US Core Encounter Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-encounter.html), [US Core FamilyMemberHistory Recorder Extension](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-familymemberhistory-recorder.html), [US Core FamilyMemberHistory Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-familymemberhistory.html), [US Core Goal Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-goal.html), [US Core Immunization Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-immunization.html), [US Core MedicationDispense Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-medicationdispense.html), [US Core MedicationRequest Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-medicationrequest.html), [US Core Observation ADI Documentation Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-adi-documentation.html), [US Core Observation Clinical Result Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-clinical-result.html), [US Core Observation Occupation Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-occupation.html), [US Core Observation Pregnancy Intent Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-pregnancyintent.html), [US Core Observation Pregnancy Status Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-pregnancystatus.html), [US Core Observation Screening Assessment Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-screening-assessment.html), [US Core Observation Sexual Orientation Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-observation-sexual-orientation.html), [US Core PMO ServiceRequest Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-pmo-servicerequest.html), [US Core Procedure Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-procedure.html), [US Core Provenance Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-provenance.html), [US Core QuestionnaireResponse Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-questionnaireresponse.html), [US Core RelatedPerson Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-relatedperson.html), [US Core ServiceRequest Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-servicerequest.html), [US Core Simple Observation Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-simple-observation.html), [US Core Smoking Status Observation Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-smokingstatus.html), [US Core Specimen Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-specimen.html), [US Core Treatment Intervention Preference Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-treatment-intervention-preference.html) and [US Core Vital Signs Profile](http://hl7.org/fhir/us/core/2026Jan/StructureDefinition-us-core-vital-signs.html)
* Examples for this Profile: [Patient/patient-accommodation-asl](Patient-patient-accommodation-asl.md), [Patient/patient-accommodation-service-animal](Patient-patient-accommodation-service-animal.md), [Patient/patient-accommodation-wheelchair](Patient-patient-accommodation-wheelchair.md), [Patient/patient-healthcare-agent-primary-first](Patient-patient-healthcare-agent-primary-first.md) and [Patient/patient-healthcare-agent](Patient-patient-healthcare-agent.md)
* CapabilityStatements using this Profile: [US Core Client CapabilityStatement](http://hl7.org/fhir/us/core/2026Jan/CapabilityStatement-us-core-client.html) and [US Core Server CapabilityStatement](http://hl7.org/fhir/us/core/2026Jan/CapabilityStatement-us-core-server.html)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.us.healthedata1-sandbox|current/StructureDefinition/StructureDefinition-us-core-patient.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-us-core-patient.csv), [Excel](StructureDefinition-us-core-patient.xlsx), [Schematron](StructureDefinition-us-core-patient.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "us-core-patient",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 5
  }],
  "url" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.2.42.50"
  }],
  "version" : "0.1.0",
  "name" : "USCorePatientProfile",
  "title" : "US Core Patient Profile",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-05-14",
  "publisher" : "HL7 International / Cross-Group Projects",
  "contact" : [{
    "name" : "HL7 International / Cross-Group Projects",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/cgp"
    },
    {
      "system" : "email",
      "value" : "cgp@lists.HL7.org"
    }]
  }],
  "description" : "The US Core Patient Profile inherits from the FHIR [Patient](https://hl7.org/fhir/R4/patient.html) resource; refer to it for scope and usage definitions. This profile meets the requirements of the [U.S. Core Data for Interoperability (USCDI)](https://www.healthit.gov/isp/united-states-core-data-interoperability-uscdi) *Patient Demographics/Information* Data Class. It sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "cda",
    "uri" : "http://hl7.org/v3/cda",
    "name" : "CDA (R2)"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "loinc",
    "uri" : "http://loinc.org",
    "name" : "LOINC code for the element"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Patient",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Patient",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Patient",
      "path" : "Patient",
      "mustSupport" : false
    },
    {
      "id" : "Patient.extension:race",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.extension",
      "sliceName" : "race",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"]
      }],
      "mustSupport" : false
    },
    {
      "id" : "Patient.extension:ethnicity",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.extension",
      "sliceName" : "ethnicity",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"]
      }],
      "mustSupport" : false
    },
    {
      "id" : "Patient.extension:tribalAffiliation",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.extension",
      "sliceName" : "tribalAffiliation",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation"]
      }],
      "mustSupport" : false
    },
    {
      "id" : "Patient.extension:sex",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.extension",
      "sliceName" : "sex",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex"]
      }],
      "mustSupport" : false
    },
    {
      "id" : "Patient.extension:interpreterRequired",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.extension",
      "sliceName" : "interpreterRequired",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed"]
      }],
      "mustSupport" : false
    },
    {
      "id" : "Patient.identifier",
      "path" : "Patient.identifier",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier.system",
      "path" : "Patient.identifier.system",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier.value",
      "path" : "Patient.identifier.value",
      "short" : "The value that is unique within the system.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.name",
      "path" : "Patient.name",
      "min" : 1,
      "constraint" : [{
        "key" : "us-core-6",
        "severity" : "error",
        "human" : "At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present.",
        "expression" : "(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()",
        "xpath" : "(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason' and not(/f:family or /f:given)) or (not(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason') and (/f:family or /f:given))"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.name.use",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.name.use",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden",
      "comment" : "The [United States Core Data for Interoperability (USCDI)](https://www.healthit.gov/isp/united-states-core-data-interoperability-uscdi) Patient Demographics/Information Data Element, *Name to Use*, is represented by the code \"usual\", and, *Previous Name*, by the code \"old\"."
    },
    {
      "id" : "Patient.name.family",
      "path" : "Patient.name.family",
      "condition" : ["us-core-6"],
      "mustSupport" : true
    },
    {
      "id" : "Patient.name.given",
      "path" : "Patient.name.given",
      "condition" : ["us-core-6"],
      "mustSupport" : true
    },
    {
      "id" : "Patient.name.suffix",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.name.suffix",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name",
      "mustSupport" : false
    },
    {
      "id" : "Patient.name.period",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.name.period",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use",
      "mustSupport" : false
    },
    {
      "id" : "Patient.telecom",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.telecom",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual",
      "mustSupport" : false
    },
    {
      "id" : "Patient.telecom.system",
      "path" : "Patient.telecom.system",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "description" : "Telecommunications form for contact point.",
        "valueSet" : "http://hl7.org/fhir/ValueSet/contact-point-system"
      }
    },
    {
      "id" : "Patient.telecom.value",
      "path" : "Patient.telecom.value",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.telecom.use",
      "path" : "Patient.telecom.use",
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://hl7.org/fhir/ValueSet/contact-point-use"
      }
    },
    {
      "id" : "Patient.birthDate",
      "path" : "Patient.birthDate",
      "mustSupport" : true
    },
    {
      "id" : "Patient.deceased[x]",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.deceased[x]",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not"
    },
    {
      "id" : "Patient.address",
      "path" : "Patient.address",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.use",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.address.use",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address"
    },
    {
      "id" : "Patient.address.line",
      "path" : "Patient.address.line",
      "example" : [{
        "label" : "US Core",
        "valueString" : "49 MEADOW ST"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.city",
      "path" : "Patient.address.city",
      "example" : [{
        "label" : "US Core",
        "valueString" : "EVERYTOWN"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.state",
      "path" : "Patient.address.state",
      "example" : [{
        "label" : "US Core",
        "valueString" : "OK"
      }],
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "description" : "Two Letter USPS alphabetic codes.",
        "valueSet" : "http://terminology.hl7.org/ValueSet/USPS-State"
      }
    },
    {
      "id" : "Patient.address.postalCode",
      "path" : "Patient.address.postalCode",
      "short" : "US Zip Codes",
      "alias" : ["Zip Code"],
      "example" : [{
        "label" : "US Core",
        "valueString" : "74047"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.period",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.address.period",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use"
    },
    {
      "id" : "Patient.contact",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.contact",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient",
      "min" : 0,
      "max" : "*"
    },
    {
      "id" : "Patient.contact.relationship",
      "path" : "Patient.contact.relationship",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/core/ValueSet/us-core-patient-contact-relationship"
      }
    },
    {
      "id" : "Patient.contact.name",
      "path" : "Patient.contact.name",
      "mustSupport" : true
    },
    {
      "id" : "Patient.contact.telecom",
      "path" : "Patient.contact.telecom",
      "mustSupport" : true
    },
    {
      "id" : "Patient.communication",
      "extension" : [{
        "url" : "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
        "valueBoolean" : true
      }],
      "path" : "Patient.communication",
      "short" : "𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health",
      "mustSupport" : false
    },
    {
      "id" : "Patient.communication.language",
      "path" : "Patient.communication.language",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://terminology.hl7.org/ValueSet/Languages"
      }
    }]
  }
}

```
