Health eData 1 Sandbox, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/argonautproject/USCDIV7/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient | Version: 0.1.0 | |||
| Active as of 2026-05-14 | Maturity Level: 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 resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for 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:
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:
Each Patient Must Support:
| home | work | temp | old | mobile - purpose of this contact point |
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.
| πππππ§ππ’π‘ππ π¨π¦πππ: usual | official | temp | nickname | anonymous | old | maiden |
| πππππ§ππ’π‘ππ π¨π¦πππ: home | work | temp | old | billing - purpose of this address |
This section provides detailed implementation guidance for the US Core Profile to support implementation and certification.
{% include structure-table.md sd=sd source="differential" show_must_support=true show_uscdi=true %}
The US Core Patient Profile inherits from the FHIR Patient resource; refer to it for scope and usage definitions. This profile meets the requirements of the U.S. Core Data for 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.
http://hl7.org/fhir/us/core/StructureDefinition/us-core-patientPatienthttp://hl7.org/fhir/StructureDefinition/Patient| Element | Must Support | Add'l USCDI | Cardinality | Type | Description |
|---|---|---|---|---|---|
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. |
β³ extensionslice: race |
Β | β | 0..1 | Extensionprofile: 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) 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. |
β³ extensionslice: ethnicity |
Β | β | 0..1 | Extensionprofile: 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) code system. Detailed ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino. |
β³ extensionslice: tribalAffiliation |
Β | β | 0..* | Extensionprofile: 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. |
β³ extensionslice: sex |
Β | β | 0..1 | Extensionprofile: 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). |
β³ extensionslice: interpreterRequired |
Β | β | 0..1 | Extensionprofile: 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 | booleandateTime |
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:
You can also check for usages in the FHIR IG Statistics
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |
![]() ![]() |
?!Ξ£ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
C | 0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Constraints: us-core-23 |
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() |
SΞ£ | 1..* | Identifier | An identifier for this patient |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . |
![]() ![]() ![]() |
SΞ£ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient |
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The value that is unique within the system. Example General: 123456 |
![]() ![]() |
?!Ξ£ | 0..1 | boolean | Whether this patient's record is in active use |
![]() ![]() |
SΞ£C | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. |
![]() ![]() ![]() |
SΞ£C | 0..1 | string | Family name (often called 'Surname') |
![]() ![]() ![]() |
SΞ£C | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name |
![]() ![]() ![]() |
Ξ£ | 0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name |
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use |
![]() ![]() |
Ξ£ | 0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual |
![]() ![]() ![]() |
SΞ£C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. |
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The actual contact point details |
![]() ![]() ![]() |
?!SΞ£ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
![]() ![]() |
SΞ£ | 0..1 | date | The date of birth for the individual |
![]() ![]() |
?!Ξ£ | 0..1 | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |
![]() ![]() ![]() |
boolean | |||
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SΞ£ | 0..* | Address | An address for the individual |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home |
![]() ![]() ![]() |
SΞ£ | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example US Core: 49 MEADOW ST |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example US Core: EVERYTOWN |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | US Zip Codes Example General: 9132 Example US Core: 74047 |
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"} |
![]() ![]() |
C | 0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient Constraints: pat-1 |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) |
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person |
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) |
![]() ![]() |
?!Ξ£ | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
Ξ£ | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to |
![]() ![]() ![]() |
Ξ£ | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource. |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.identifier.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| Patient.name.use | Base | required | NameUse | 📍4.0.1 | FHIR Std. |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Patient | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Patient | A resource should have narrative for robust management |
text.`div`.exists()
|
| 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()
|
| pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization |
name.exists() or telecom.exists() or address.exists() or organization.exists()
|
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
| us-core-23 | error | Patient.extension:race | If "ASKU" or "UNK" are present, then no other OMB race categories can be present. |
extension.where(url = 'ombCategory').value.where(code in 'ASKU'|'UNK').exists() implies extension.where(url = 'ombCategory').count() = 1
|
This structure is derived from Patient
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race | |
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |
![]() ![]() |
S | 1..* | Identifier | An identifier for this patient |
![]() ![]() ![]() |
S | 1..1 | uri | The namespace for the identifier value |
![]() ![]() ![]() |
S | 1..1 | string | The value that is unique within the system. |
![]() ![]() |
SC | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 |
![]() ![]() ![]() |
0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden | |
![]() ![]() ![]() |
SC | 0..1 | string | Family name (often called 'Surname') |
![]() ![]() ![]() |
SC | 0..* | string | Given names (not always 'first'). Includes middle names |
![]() ![]() ![]() |
0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name | |
![]() ![]() ![]() |
0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use | |
![]() ![]() |
0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual | |
![]() ![]() ![]() |
S | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. |
![]() ![]() ![]() |
S | 1..1 | string | The actual contact point details |
![]() ![]() ![]() |
S | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
![]() ![]() |
S | 0..1 | date | The date of birth for the individual |
![]() ![]() |
0..1 | boolean, dateTime | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |
![]() ![]() |
S | 0..* | Address | An address for the individual |
![]() ![]() ![]() |
0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address | |
![]() ![]() ![]() |
S | 0..* | string | Street name, number, direction & P.O. Box etc. Example US Core: 49 MEADOW ST |
![]() ![]() ![]() |
S | 0..1 | string | Name of city, town etc. Example US Core: EVERYTOWN |
![]() ![]() ![]() |
S | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK |
![]() ![]() ![]() |
S | 0..1 | string | US Zip Codes Example US Core: 74047 |
![]() ![]() ![]() |
0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use | |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) |
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person |
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Id | Grade | Path(s) | Description | Expression |
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |||||
![]() ![]() |
Ξ£ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
Ξ£ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() |
?!Ξ£ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
C | 0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Constraints: us-core-23 | ||||
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |||||
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |||||
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |||||
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
SΞ£ | 1..* | Identifier | An identifier for this patient | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The value that is unique within the system. Example General: 123456 | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | Time period when id is/was valid for use | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
![]() ![]() |
?!Ξ£ | 0..1 | boolean | Whether this patient's record is in active use | ||||
![]() ![]() |
SΞ£C | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Text representation of the full name | ||||
![]() ![]() ![]() |
SΞ£C | 0..1 | string | Family name (often called 'Surname') | ||||
![]() ![]() ![]() |
SΞ£C | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use | ||||
![]() ![]() |
Ξ£ | 0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
SΞ£C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The actual contact point details | ||||
![]() ![]() ![]() |
?!SΞ£ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | Time period when the contact point was/is in use | ||||
![]() ![]() |
Ξ£ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | ||||
![]() ![]() |
SΞ£ | 0..1 | date | The date of birth for the individual | ||||
![]() ![]() |
?!Ξ£ | 0..1 | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |||||
![]() ![]() ![]() |
boolean | |||||||
![]() ![]() ![]() |
dateTime | |||||||
![]() ![]() |
SΞ£ | 0..* | Address | An address for the individual | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | code | postal | physical | both Binding: AddressType (required): The type of an address (physical / postal). Example General: both | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132 | ||||
![]() ![]() ![]() |
SΞ£ | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example US Core: 49 MEADOW ST | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example US Core: EVERYTOWN | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | District name (aka county) Example General: Madison | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | US Zip Codes Example General: 9132 Example US Core: 74047 | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"} | ||||
![]() ![]() |
0..1 | CodeableConcept | Marital (civil) status of a patient Binding: Marital Status Codes (extensible): The domestic partnership status of a person. | |||||
![]() ![]() |
0..1 | Whether patient is part of a multiple birth | ||||||
![]() ![]() ![]() |
boolean | |||||||
![]() ![]() ![]() |
integer | |||||||
![]() ![]() |
0..* | Attachment | Image of the patient | |||||
![]() ![]() |
C | 0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient Constraints: pat-1 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) | ||||
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person | ||||
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person | ||||
![]() ![]() ![]() |
0..1 | Address | Address for the contact person | |||||
![]() ![]() ![]() |
0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | |||||
![]() ![]() ![]() |
C | 0..1 | Reference(Organization) | Organization that is associated with the contact | ||||
![]() ![]() ![]() |
0..1 | Period | The period during which this contact person or organization is valid to be contacted relating to this patient | |||||
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) | ||||
![]() ![]() ![]() |
0..1 | boolean | Language preference indicator | |||||
![]() ![]() |
0..* | Reference(Organization | Practitioner | PractitionerRole) | Patient's nominated primary care provider | |||||
![]() ![]() |
Ξ£ | 0..1 | Reference(Organization) | Organization that is the custodian of the patient record | ||||
![]() ![]() |
?!Ξ£ | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
Ξ£ | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to | ||||
![]() ![]() ![]() |
Ξ£ | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource. | ||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Patient.identifier.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| Patient.identifier.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| Patient.name.use | Base | required | NameUse | 📍4.0.1 | FHIR Std. |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| Patient.address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std. |
| Patient.address.type | Base | required | AddressType | 📍4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.maritalStatus | Base | extensible | MaritalStatus | 📍4.0.1 | FHIR Std. |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.contact.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Patient | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Patient | A resource should have narrative for robust management |
text.`div`.exists()
|
| 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()
|
| pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization |
name.exists() or telecom.exists() or address.exists() or organization.exists()
|
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
| us-core-23 | error | Patient.extension:race | If "ASKU" or "UNK" are present, then no other OMB race categories can be present. |
extension.where(url = 'ombCategory').value.where(code in 'ASKU'|'UNK').exists() implies extension.where(url = 'ombCategory').count() = 1
|
This structure is derived from Patient
Summary
Mandatory: 4 elements(2 nested mandatory elements)
Must-Support: 19 elements
Extensions
This structure refers to these extensions:
Maturity: 5
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |
![]() ![]() |
?!Ξ£ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
C | 0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Constraints: us-core-23 |
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() |
SΞ£ | 1..* | Identifier | An identifier for this patient |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . |
![]() ![]() ![]() |
SΞ£ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient |
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The value that is unique within the system. Example General: 123456 |
![]() ![]() |
?!Ξ£ | 0..1 | boolean | Whether this patient's record is in active use |
![]() ![]() |
SΞ£C | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. |
![]() ![]() ![]() |
SΞ£C | 0..1 | string | Family name (often called 'Surname') |
![]() ![]() ![]() |
SΞ£C | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name |
![]() ![]() ![]() |
Ξ£ | 0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name |
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use |
![]() ![]() |
Ξ£ | 0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual |
![]() ![]() ![]() |
SΞ£C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. |
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The actual contact point details |
![]() ![]() ![]() |
?!SΞ£ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
![]() ![]() |
SΞ£ | 0..1 | date | The date of birth for the individual |
![]() ![]() |
?!Ξ£ | 0..1 | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |
![]() ![]() ![]() |
boolean | |||
![]() ![]() ![]() |
dateTime | |||
![]() ![]() |
SΞ£ | 0..* | Address | An address for the individual |
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home |
![]() ![]() ![]() |
SΞ£ | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example US Core: 49 MEADOW ST |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example US Core: EVERYTOWN |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK |
![]() ![]() ![]() |
SΞ£ | 0..1 | string | US Zip Codes Example General: 9132 Example US Core: 74047 |
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"} |
![]() ![]() |
C | 0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient Constraints: pat-1 |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) |
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person |
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) |
![]() ![]() |
?!Ξ£ | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person |
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
Ξ£ | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to |
![]() ![]() ![]() |
Ξ£ | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource. |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.identifier.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| Patient.name.use | Base | required | NameUse | 📍4.0.1 | FHIR Std. |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Patient | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Patient | A resource should have narrative for robust management |
text.`div`.exists()
|
| 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()
|
| pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization |
name.exists() or telecom.exists() or address.exists() or organization.exists()
|
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
| us-core-23 | error | Patient.extension:race | If "ASKU" or "UNK" are present, then no other OMB race categories can be present. |
extension.where(url = 'ombCategory').value.where(code in 'ASKU'|'UNK').exists() implies extension.where(url = 'ombCategory').count() = 1
|
Differential View
This structure is derived from Patient
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race | |
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |
![]() ![]() |
S | 1..* | Identifier | An identifier for this patient |
![]() ![]() ![]() |
S | 1..1 | uri | The namespace for the identifier value |
![]() ![]() ![]() |
S | 1..1 | string | The value that is unique within the system. |
![]() ![]() |
SC | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 |
![]() ![]() ![]() |
0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden | |
![]() ![]() ![]() |
SC | 0..1 | string | Family name (often called 'Surname') |
![]() ![]() ![]() |
SC | 0..* | string | Given names (not always 'first'). Includes middle names |
![]() ![]() ![]() |
0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name | |
![]() ![]() ![]() |
0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use | |
![]() ![]() |
0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual | |
![]() ![]() ![]() |
S | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. |
![]() ![]() ![]() |
S | 1..1 | string | The actual contact point details |
![]() ![]() ![]() |
S | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
![]() ![]() |
S | 0..1 | date | The date of birth for the individual |
![]() ![]() |
0..1 | boolean, dateTime | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |
![]() ![]() |
S | 0..* | Address | An address for the individual |
![]() ![]() ![]() |
0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address | |
![]() ![]() ![]() |
S | 0..* | string | Street name, number, direction & P.O. Box etc. Example US Core: 49 MEADOW ST |
![]() ![]() ![]() |
S | 0..1 | string | Name of city, town etc. Example US Core: EVERYTOWN |
![]() ![]() ![]() |
S | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK |
![]() ![]() ![]() |
S | 0..1 | string | US Zip Codes Example US Core: 74047 |
![]() ![]() ![]() |
0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use | |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient | |
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) |
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person |
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person |
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Id | Grade | Path(s) | Description | Expression |
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | Patient | Information about an individual or animal receiving health care services | |||||
![]() ![]() |
Ξ£ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
Ξ£ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() |
?!Ξ£ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
C | 0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core Race Extension. (multiple races are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Constraints: us-core-23 | ||||
![]() ![]() ![]() |
0..1 | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: US Core ethnicity Extension (multiple ethnicities are supported in the extension) URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity | |||||
![]() ![]() ![]() |
0..* | (Complex) | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Tribal Affiliation Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation | |||||
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Sex Extension URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-individual-sex Binding: Federal Administrative Sex (extensible): Federal Administrative Sex | |||||
![]() ![]() ![]() |
0..1 | Coding | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Whether the patient needs an interpreter URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed Binding: Answer Set with Yes No and Unknowns (required): Answer Set with Yes No and Unknowns | |||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
SΞ£ | 1..* | Identifier | An identifier for this patient | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The value that is unique within the system. Example General: 123456 | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | Time period when id is/was valid for use | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
![]() ![]() |
?!Ξ£ | 0..1 | boolean | Whether this patient's record is in active use | ||||
![]() ![]() |
SΞ£C | 1..* | HumanName | A name associated with the patient Constraints: us-core-6 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Text representation of the full name | ||||
![]() ![]() ![]() |
SΞ£C | 0..1 | string | Family name (often called 'Surname') | ||||
![]() ![]() ![]() |
SΞ£C | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..* | string | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when name was/is in use | ||||
![]() ![]() |
Ξ£ | 0..* | ContactPoint | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact detail for the individual | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
SΞ£C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. | ||||
![]() ![]() ![]() |
SΞ£ | 1..1 | string | The actual contact point details | ||||
![]() ![]() ![]() |
?!SΞ£ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | Time period when the contact point was/is in use | ||||
![]() ![]() |
Ξ£ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | ||||
![]() ![]() |
SΞ£ | 0..1 | date | The date of birth for the individual | ||||
![]() ![]() |
?!Ξ£ | 0..1 | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Indicates if the individual is deceased or not | |||||
![]() ![]() ![]() |
boolean | |||||||
![]() ![]() ![]() |
dateTime | |||||||
![]() ![]() |
SΞ£ | 0..* | Address | An address for the individual | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..1 | code | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | code | postal | physical | both Binding: AddressType (required): The type of an address (physical / postal). Example General: both | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132 | ||||
![]() ![]() ![]() |
SΞ£ | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example US Core: 49 MEADOW ST | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example US Core: EVERYTOWN | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | District name (aka county) Example General: Madison | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible): Two Letter USPS alphabetic codes. Example US Core: OK | ||||
![]() ![]() ![]() |
SΞ£ | 0..1 | string | US Zip Codes Example General: 9132 Example US Core: 74047 | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) | ||||
![]() ![]() ![]() |
Ξ£ | 0..1 | Period | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"} | ||||
![]() ![]() |
0..1 | CodeableConcept | Marital (civil) status of a patient Binding: Marital Status Codes (extensible): The domestic partnership status of a person. | |||||
![]() ![]() |
0..1 | Whether patient is part of a multiple birth | ||||||
![]() ![]() ![]() |
boolean | |||||||
![]() ![]() ![]() |
integer | |||||||
![]() ![]() |
0..* | Attachment | Image of the patient | |||||
![]() ![]() |
C | 0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A contact party (e.g., guardian, healthcare agent, friend) for the patient Constraints: pat-1 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
S | 0..* | CodeableConcept | The kind of relationship Binding: US Core Patient Contact Relationship (extensible) | ||||
![]() ![]() ![]() |
S | 0..1 | HumanName | A name associated with the contact person | ||||
![]() ![]() ![]() |
S | 0..* | ContactPoint | A contact detail for the person | ||||
![]() ![]() ![]() |
0..1 | Address | Address for the contact person | |||||
![]() ![]() ![]() |
0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | |||||
![]() ![]() ![]() |
C | 0..1 | Reference(Organization) | Organization that is associated with the contact | ||||
![]() ![]() ![]() |
0..1 | Period | The period during which this contact person or organization is valid to be contacted relating to this patient | |||||
![]() ![]() |
0..* | BackboneElement | 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗨𝗦𝗖𝗗𝗜: A language which may be used to communicate with the patient about his or her health | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
S | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: Languages (extensible) | ||||
![]() ![]() ![]() |
0..1 | boolean | Language preference indicator | |||||
![]() ![]() |
0..* | Reference(Organization | Practitioner | PractitionerRole) | Patient's nominated primary care provider | |||||
![]() ![]() |
Ξ£ | 0..1 | Reference(Organization) | Organization that is the custodian of the patient record | ||||
![]() ![]() |
?!Ξ£ | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Ξ£ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
Ξ£ | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to | ||||
![]() ![]() ![]() |
Ξ£ | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource. | ||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Patient.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Patient.identifier.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| Patient.identifier.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| Patient.name.use | Base | required | NameUse | 📍4.0.1 | FHIR Std. |
| Patient.telecom.system | Base | required | ContactPointSystem | 📦4.0.1 | FHIR Std. |
| Patient.telecom.use | Base | required | ContactPointUse | 📦4.0.1 | FHIR Std. |
| Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| Patient.address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std. |
| Patient.address.type | Base | required | AddressType | 📍4.0.1 | FHIR Std. |
| Patient.address.state | Base | extensible | USPS Two Letter Alphabetic Codes | 📦1.0.0 | THO v7.1 |
| Patient.maritalStatus | Base | extensible | MaritalStatus | 📍4.0.1 | FHIR Std. |
| Patient.contact.relationship | Base | extensible | US Core Patient Contact Relationship | 📦0.1.0 | This IG |
| Patient.contact.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| Patient.communication.βlanguage | Base | extensible | Languages | 📦1.0.0 | THO v7.1 |
| Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Patient | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Patient | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Patient | A resource should have narrative for robust management |
text.`div`.exists()
|
| 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()
|
| pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization |
name.exists() or telecom.exists() or address.exists() or organization.exists()
|
| us-core-6 | error | Patient.name | At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. |
(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()
|
| us-core-23 | error | Patient.extension:race | If "ASKU" or "UNK" are present, then no other OMB race categories can be present. |
extension.where(url = 'ombCategory').value.where(code in 'ASKU'|'UNK').exists() implies extension.where(url = 'ombCategory').count() = 1
|
This structure is derived from Patient
Summary
Mandatory: 4 elements(2 nested mandatory elements)
Must-Support: 19 elements
Extensions
This structure refers to these extensions:
Maturity: 5
Other representations of profile: CSV, Excel, Schematron