Person | Medplum
On this page
Demographics and administrative information about a person independent of a specific health-related context.
Elements
| Name | Required | Type | Description |
|---|---|---|---|
| identifier | Identifier[] | A human identifier for this person Details Identifier for a person within a particular scope. |
|
| name | HumanName[] | A name associated with the person Details A name associated with the person. Person may have multiple names with different uses or applicable periods. |
|
| telecom | ContactPoint[] | A contact detail for the person Details A contact detail for the person, e.g. a telephone number or an email address. Person may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently and also to help with identification. |
|
| gender | code | male | female | other | unknown Details Administrative Gender. The gender might not match the biological sex as determined by genetics, or the individual's preferred identification. |
|
| birthDate | date | The date on which the person was born Details The birth date for the person. At least an estimated year should be provided as a guess if the real DOB is unknown. |
|
| address | Address[] | One or more addresses for the person Details One or more addresses for the person. Person may have multiple addresses with different uses or applicable periods. |
|
| photo | Attachment | Image of the person Details An image that can be displayed as a thumbnail of the person to enhance the identification of the individual. |
|
| managingOrganization | Reference< Organization > | The organization that is the custodian of the person record Details The organization that is the custodian of the person record. |
|
| active | boolean | This person's record is in active use Details Whether this person's record is in active use. |
|
| link | PersonLink[] | Link to a resource that concerns the same actual person Details Link to a resource that concerns the same actual person. |
|
| id | string | Unique id for inter-element referencing Details Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
|
| extension | Extension[] | Additional content defined by implementations Details May be used to represent additional information that is not part of the basic definition of the element. |
|
| modifierExtension | Extension[] | Extensions that cannot be ignored even if unrecognized Details May be used to represent additional information that modifies the understanding of the element. |
|
| target | ✓ | Reference< Patient | Practitioner | RelatedPerson | Person > |
The resource to which this actual person is associated Details The resource to which this actual person is associated. |
| assurance | code | level1 | level2 | level3 | level4 Details Level of assurance that this link is associated with the target resource. |
Search Parameters
| Name | Type | Description | Expression |
|---|---|---|---|
| address | string | A server-defined search that may match any of the string fields in the Address | Person.address | RelatedPerson.address |
| address-city | string | A city specified in an address | Person.address.city | RelatedPerson.address.city |
| address-country | string | A country specified in an address | Person.address.country | RelatedPerson.address.country |
| address-postalcode | string | A postal code specified in an address | Person.address.postalCode | RelatedPerson.address.postalCode |
| address-state | string | A state specified in an address | Person.address.state | RelatedPerson.address.state |
| address-use | token | A use code specified in an address | Person.address.use | RelatedPerson.address.use |
| birthdate | date | The person's date of birth | Person.birthDate | RelatedPerson.birthDate |
| token | A value in an email contact | Person.telecom.where((system = 'email')) | RelatedPerson.telecom.where((system = 'email')) | |
| gender | token | The gender of the person | Person.gender | RelatedPerson.gender |
| phone | token | A value in a phone contact | Person.telecom.where((system = 'phone')) | RelatedPerson.telecom.where((system = 'phone')) |
| phonetic | string | A portion of name using some kind of phonetic matching algorithm | Person.name | RelatedPerson.name |
| telecom | token | The value in any kind of contact | Person.telecom | RelatedPerson.telecom |
| identifier | token | A person Identifier | Person.identifier |
| link | reference | Any link has this Patient, Person, RelatedPerson or Practitioner reference | Person.link.target |
| name | string | A server-defined search that may match any of the string fields in the HumanName | Person.name |
| organization | reference | The organization at which this person record is being managed | Person.managingOrganization |
| patient | reference | The Person links to this Patient | Person.link.target.where((resolve() is Patient)) |
| practitioner | reference | The Person links to this Practitioner | Person.link.target.where((resolve() is Practitioner)) |
| relatedperson | reference | The Person links to this RelatedPerson | Person.link.target.where((resolve() is RelatedPerson)) |
Inherited Elements
| Name | Required | Type | Description |
|---|---|---|---|
| id | string | Logical id of this artifact Details The logical id of the resource, as used in the URL for the resource. |
|
| meta | Meta | Metadata about the resource Details The metadata about the resource. |
|
| implicitRules | uri | A set of rules under which this content was created Details A reference to a set of rules that were followed when the resource was constructed. |
|
| language | code | Language of the resource content Details The base language in which the resource is written. |
|
| text | Narrative | Text summary of the resource, for human interpretation Details A human-readable narrative that contains a summary of the resource. |
|
| contained | Resource[] | Contained, inline Resources Details These resources do not have an independent existence apart from the resource that contains them. |
|
| extension | Extension[] | Additional content defined by implementations Details May be used to represent additional information. |
|
| modifierExtension | Extension[] | Extensions that cannot be ignored Details May be used to represent additional information that modifies the understanding of the element. |
Summary
The Person resource serves as a linkage resource that may provide a reference set of common demographics for an individual (human or animal) across multiple roles. This linkage can be direct to role-specific FHIR resources (Patient, Practitioner and RelatedPerson) or indirectly through the use of business identifiers.
Person instances are never directly referenced as actors (authors, subjects, performers, etc.). Individual actors are always identified as either Patient, Practitioner or RelatedPerson.
The Person resource is an advanced feature and may not be implemented in all systems.