> ## 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.

# Patient

> Demographics and other administrative information about an individual or animal receiving care or other health-related services.

## Properties

| Name                 | Required | Type                                                                                                                                                                                                  | Description                                                                                                   |
| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| identifier           | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                              | An identifier for this patient                                                                                |
| active               | No       | boolean                                                                                                                                                                                               | Whether this patient's record is in active use                                                                |
| name                 | No       | [HumanName](/medical-api/fhir/data-types/humanname)\[]                                                                                                                                                | A name associated with the patient                                                                            |
| telecom              | No       | [ContactPoint](/medical-api/fhir/data-types/contactpoint)\[]                                                                                                                                          | A contact detail for the individual                                                                           |
| gender               | No       | code                                                                                                                                                                                                  | male / female / other / unknown                                                                               |
| birthDate            | No       | date                                                                                                                                                                                                  | The date of birth for the individual                                                                          |
| deceased\[x]         | No       | boolean, dateTime                                                                                                                                                                                     | Indicates if the individual is deceased or not                                                                |
| address              | No       | [Address](/medical-api/fhir/data-types/address)\[]                                                                                                                                                    | An address for the individual                                                                                 |
| maritalStatus        | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                       | Marital (civil) status of a patient                                                                           |
| multipleBirth\[x]    | No       | boolean, integer                                                                                                                                                                                      | Whether patient is part of a multiple birth                                                                   |
| photo                | No       | [Attachment](/medical-api/fhir/data-types/attachment)\[]                                                                                                                                              | Image of the patient                                                                                          |
| contact              | No       | PatientContact                                                                                                                                                                                        | A contact party (e.g. guardian, partner, friend) for the patient                                              |
| - 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                                                        |
| - relationship       | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                    | The kind of relationship                                                                                      |
| - name               | No       | [HumanName](/medical-api/fhir/data-types/humanname)                                                                                                                                                   | A name associated with the contact person                                                                     |
| - telecom            | No       | [ContactPoint](/medical-api/fhir/data-types/contactpoint)\[]                                                                                                                                          | A contact detail for the person                                                                               |
| - address            | No       | [Address](/medical-api/fhir/data-types/address)                                                                                                                                                       | Address for the contact person                                                                                |
| - gender             | No       | code                                                                                                                                                                                                  | male / female / other / unknown                                                                               |
| - organization       | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>                                                                                                                                  | Organization that is associated with the contact                                                              |
| - period             | No       | [Period](/medical-api/fhir/data-types/period)                                                                                                                                                         | The period during which this contact person or organization is valid to be contacted relating to this patient |
| communication        | No       | PatientCommunication                                                                                                                                                                                  | A language which may be used to communicate with the patient about his or her health                          |
| - 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                                                        |
| - language           | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                       | The language which can be used to communicate with the patient about his or her health                        |
| - preferred          | No       | boolean                                                                                                                                                                                               | Language preference indicator                                                                                 |
| generalPractitioner  | No       | Reference\<[Organization](/medical-api/fhir/resources/organization) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)>\[] | Patient's nominated primary care provider                                                                     |
| managingOrganization | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>                                                                                                                                  | Organization that is the custodian of the patient record                                                      |
| link                 | No       | PatientLink                                                                                                                                                                                           | Link to another patient 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                                                        |
| - other              | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient) / [RelatedPerson](/medical-api/fhir/resources/relatedperson)>                                                                               | The other patient or related person resource that the link refers to                                          |
| - type               | Yes      | code                                                                                                                                                                                                  | replaced-by / replaces / refer / seealso                                                                      |

## Search Parameters

| Name                 | Type      | Description                                                                                                                                             | Expression                     |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| active               | token     | Whether the patient record is active                                                                                                                    | Patient.active                 |
| 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 | Patient.address                |
| address-city         | string    | A city specified in an address                                                                                                                          | Patient.address.city           |
| address-country      | string    | A country specified in an address                                                                                                                       | Patient.address.country        |
| address-postalcode   | string    | A postalCode specified in an address                                                                                                                    | Patient.address.postalCode     |
| address-state        | string    | A state specified in an address                                                                                                                         | Patient.address.state          |
| address-use          | token     | A use code specified in an address                                                                                                                      | Patient.address.use            |
| birthdate            | date      | The patient's date of birth                                                                                                                             | Patient.birthDate              |
| death-date           | date      | The date of death has been provided and satisfies this search value                                                                                     | Patient.deceased               |
| deceased             | token     | This patient has been marked as deceased, or as a death date entered                                                                                    | Patient.deceased               |
| email                | token     | A value in an email contact                                                                                                                             | Patient.telecom                |
| family               | string    | A portion of the family name of the patient                                                                                                             | Patient.name.family            |
| gender               | token     | Gender of the patient                                                                                                                                   | Patient.gender                 |
| general-practitioner | reference | Patient's nominated general practitioner, not the organization that manages the record                                                                  | Patient.generalPractitioner    |
| given                | string    | A portion of the given name of the patient                                                                                                              | Patient.name.given             |
| identifier           | token     | A patient identifier                                                                                                                                    | Patient.identifier             |
| language             | token     | Language code (irrespective of use value)                                                                                                               | Patient.communication.language |
| link                 | reference | All patients linked to the given patient                                                                                                                | Patient.link.other             |
| 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           | Patient.name                   |
| organization         | reference | The organization that is the custodian of the patient record                                                                                            | Patient.managingOrganization   |
| phone                | token     | A value in a phone contact                                                                                                                              | Patient.telecom                |
| phonetic             | string    | A portion of either family or given name using some kind of phonetic matching algorithm                                                                 | Patient.name                   |
| telecom              | token     | The value in any kind of telecom details of the patient                                                                                                 | Patient.telecom                |

## 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 [Patient](https://www.hl7.org/fhir/StructureDefinition/Patient).
