## On this page

Demographics and administrative information about a person independent of a specific health-related context.

### Elements

| Name | Required | Type | Description |
| --- | --- | --- | --- |
| identifier |  | [Identifier](/content/docs/api/fhir/datatypes/identifier/index.html)[] | A human identifier for this person<br>Details<br>Identifier for a person within a particular scope. |
| name |  | [HumanName](/content/docs/api/fhir/datatypes/humanname/index.html)[] | A name associated with the person<br>Details<br>A name associated with the person.<br>Person may have multiple names with different uses or applicable periods. |
| telecom |  | [ContactPoint](/content/docs/api/fhir/datatypes/contactpoint/index.html)[] | A contact detail for the person<br>Details<br>A contact detail for the person, e.g. a telephone number or an email address.<br>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<br>Details<br>Administrative Gender.<br>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<br>Details<br>The birth date for the person.<br>At least an estimated year should be provided as a guess if the real DOB is unknown. |
| address |  | [Address](/content/docs/api/fhir/datatypes/address/index.html)[] | One or more addresses for the person<br>Details<br>One or more addresses for the person.<br>Person may have multiple addresses with different uses or applicable periods. |
| photo |  | [Attachment](/content/docs/api/fhir/datatypes/attachment/index.html) | Image of the person<br>Details<br>An image that can be displayed as a thumbnail of the person to enhance the identification of the individual. |
| managingOrganization |  | Reference< [Organization](/content/docs/api/fhir/resources/organization/index.html) > | The organization that is the custodian of the person record<br>Details<br>The organization that is the custodian of the person record. |
| active |  | boolean | This person's record is in active use<br>Details<br>Whether this person's record is in active use. |
| link |  | PersonLink[] | Link to a resource that concerns the same actual person<br>Details<br>Link to a resource that concerns the same actual person. |
| id |  | string | Unique id for inter-element referencing<br>Details<br>Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| extension |  | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[] | Additional content defined by implementations<br>Details<br>May be used to represent additional information that is not part of the basic definition of the element. |
| modifierExtension |  | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[] | Extensions that cannot be ignored even if unrecognized<br>Details<br>May be used to represent additional information that modifies the understanding of the element. |
| target | ✓ | Reference< [Patient](/content/docs/api/fhir/resources/patient/index.html)<br> \| [Practitioner](/content/docs/api/fhir/resources/practitioner/index.html)<br> \| [RelatedPerson](/content/docs/api/fhir/resources/relatedperson/index.html)<br> \| [Person](/content/docs/api/fhir/resources/person/index.html) > | The resource to which this actual person is associated<br>Details<br>The resource to which this actual person is associated. |
| assurance |  | code | level1 \| level2 \| level3 \| level4<br>Details<br>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 |
| email | 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<br>Details<br>The logical id of the resource, as used in the URL for the resource. |
| meta |  | [Meta](/content/docs/api/fhir/datatypes/meta/index.html) | Metadata about the resource<br>Details<br>The metadata about the resource. |
| implicitRules |  | uri | A set of rules under which this content was created<br>Details<br>A reference to a set of rules that were followed when the resource was constructed. |
| language |  | code | Language of the resource content<br>Details<br>The base language in which the resource is written. |
| text |  | [Narrative](/content/docs/api/fhir/datatypes/narrative/index.html) | Text summary of the resource, for human interpretation<br>Details<br>A human-readable narrative that contains a summary of the resource. |
| contained |  | Resource[] | Contained, inline Resources<br>Details<br>These resources do not have an independent existence apart from the resource that contains them. |
| extension |  | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[] | Additional content defined by implementations<br>Details<br>May be used to represent additional information. |
| modifierExtension |  | [Extension](/content/docs/api/fhir/datatypes/extension/index.html)[] | Extensions that cannot be ignored<br>Details<br>May be used to represent additional information that modifies the understanding of the element. |

### Summary

The [Person](/content/docs/api/fhir/resources/person/index.html) 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](/content/docs/api/fhir/resources/practitioner/index.html) and [RelatedPerson](/content/docs/api/fhir/resources/relatedperson/index.html)) or indirectly through the use of business identifiers.

[Person](/content/docs/api/fhir/resources/person/index.html) instances are never directly referenced as actors (authors, subjects, performers, etc.). Individual actors are always identified as either [Patient](/content/docs/api/fhir/resources/patient/index.html), [Practitioner](/content/docs/api/fhir/resources/practitioner/index.html) or [RelatedPerson](/content/docs/api/fhir/resources/relatedperson/index.html).

The [Person](/content/docs/api/fhir/resources/person/index.html) resource is an advanced feature and may not be implemented in all systems.