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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.