> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Person

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

## Properties

| Name                 | Required | Type                                                                                                                                                                                                                              | Description                                                 |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| identifier           | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                          | A human identifier for this person                          |
| name                 | No       | [HumanName](/medical-api/fhir/data-types/humanname)\[]                                                                                                                                                                            | A name associated with the person                           |
| telecom              | No       | [ContactPoint](/medical-api/fhir/data-types/contactpoint)\[]                                                                                                                                                                      | A contact detail for the person                             |
| gender               | No       | code                                                                                                                                                                                                                              | male / female / other / unknown                             |
| birthDate            | No       | date                                                                                                                                                                                                                              | The date on which the person was born                       |
| address              | No       | [Address](/medical-api/fhir/data-types/address)\[]                                                                                                                                                                                | One or more addresses for the person                        |
| photo                | No       | [Attachment](/medical-api/fhir/data-types/attachment)                                                                                                                                                                             | Image of the person                                         |
| managingOrganization | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>                                                                                                                                                              | The organization that is the custodian of the person record |
| active               | No       | boolean                                                                                                                                                                                                                           | This person's record is in active use                       |
| link                 | No       | PersonLink                                                                                                                                                                                                                        | Link to a resource that concerns the same actual person     |
| - id                 | No       | string                                                                                                                                                                                                                            | Unique id for inter-element referencing                     |
| - extension          | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                            | Additional content defined by implementations               |
| - modifierExtension  | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                            | Extensions that cannot be ignored even if unrecognized      |
| - target             | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Person](/medical-api/fhir/resources/person)> | The resource to which this actual person is associated      |
| - assurance          | No       | code                                                                                                                                                                                                                              | level1 / level2 / level3 / level4                           |

## Search Parameters

| Name               | Type      | Description                                                                                                                                             | Expression                  |
| ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| address            | string    | A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text | Person.address              |
| address-city       | string    | A city specified in an address                                                                                                                          | Person.address.city         |
| address-country    | string    | A country specified in an address                                                                                                                       | Person.address.country      |
| address-postalcode | string    | A postal code specified in an address                                                                                                                   | Person.address.postalCode   |
| address-state      | string    | A state specified in an address                                                                                                                         | Person.address.state        |
| address-use        | token     | A use code specified in an address                                                                                                                      | Person.address.use          |
| birthdate          | date      | The person's date of birth                                                                                                                              | Person.birthDate            |
| email              | token     | A value in an email contact                                                                                                                             | Person.telecom              |
| gender             | token     | The gender of the person                                                                                                                                | Person.gender               |
| phone              | token     | A value in a phone contact                                                                                                                              | Person.telecom              |
| phonetic           | string    | A portion of name using some kind of phonetic matching algorithm                                                                                        | Person.name                 |
| telecom            | token     | The value in any kind of contact                                                                                                                        | Person.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, including family, give, prefix, suffix, suffix, and/or text           | 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          |
| practitioner       | reference | The Person links to this Practitioner                                                                                                                   | Person.link.target          |
| relatedperson      | reference | The Person links to this RelatedPerson                                                                                                                  | Person.link.target          |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [Person](https://www.hl7.org/fhir/StructureDefinition/Person).