# PatientDemographics

Model ID: `PatientDemographics`

No description.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `active` | `boolean` | No |  |  | `true` | No | Whether the patient record is active. |
| `addresses` | array of [`Address`](./Address.md) | No |  |  |  | No | Patient's addresses (home, work, mailing, etc.). |
| `athena_patient_id` | `string|null` | No |  |  |  | Yes | Athena Health patient identifier when this patient is linked to Athena |
| `athena_practice_id` | `string|null` | No |  |  |  | Yes | Athena Health practice identifier that scopes athena_patient_id |
| `attributes` | `object` | No |  |  |  | No | Arbitrary JSON-compatible metadata for this patient |
| `communications` | array of [`Communication`](./Communication.md) | No |  |  |  | No | Languages the patient communicates in, with preferred flag. |
| `created_by` | `string` | No |  |  | `"self"` | No | Person FHIR resource ID of the creating field agent, or 'self' |
| `created_date` | `string|null` | No |  |  |  | Yes | UTC datetime when the record was created |
| `date_of_birth` | `string` | Yes | date |  |  | No | Patient's date of birth (ISO date). |
| `deceased` | `boolean` | No |  |  | `false` | No | Whether the patient is deceased. |
| `deceased_cause` | `string|null` | No |  |  |  | Yes | Cause of death, when recorded. |
| `deceased_date` | `string|null` | No |  |  |  | Yes | Date of death, when applicable. |
| `drivers_license` | [`DriversLicense`](./DriversLicense.md) | No |  |  |  | Yes | Patient's driver's license text fields, when on file. |
| `email` | `string|null` | No |  |  |  | Yes | Patient's email address, when present. |
| `emergency_contacts` | array of [`EmergencyContact`](./EmergencyContact.md) | No |  |  |  | No | Patient's emergency contacts. |
| `ethnicity` | [`Ethnicity`](./Ethnicity.md) | No |  |  |  | Yes | Hispanic or Latino ethnicity status. |
| `fhir_id` | `string|null` | No |  |  |  | Yes | FHIR resource id (assigned by server or pre-set) |
| `flags` | `object` | No |  |  |  | No | Boolean feature/state flags for this patient |
| `gender` | [`Gender`](./Gender.md) | Yes |  |  |  | No | Administrative gender: male, female, other, or unknown. |
| `gender_identity` | [`GenderIdentity`](./GenderIdentity.md) | No |  |  |  | Yes | Gender identity (US Core Patient extension). |
| `insurance` | array of [`Insurance`](./Insurance.md) | No |  |  |  | No | Patient's insurance coverages, in coordination-of-benefits order. |
| `links` | array of [`PatientLink`](./PatientLink.md) | No |  |  |  | No | Links to related or duplicate patient records. |
| `managing_organization_id` | `string|null` | No |  |  |  | Yes | FHIR Organization resource id |
| `marital_status` | [`MaritalStatus`](./MaritalStatus.md) | No |  |  |  | Yes | Marital status, when known. |
| `mrn` | `string` | Yes |  |  |  | No | Medical Record Number |
| `name` | [`PatientName`](./PatientName.md) | Yes |  |  |  | No | Patient's name (official and preferred). |
| `nationality` | `string|null` | No |  |  |  | Yes | ISO 3166-1 alpha-2 country code, e.g. 'US', 'GB', 'ZA' |
| `openloop_dietitian_id` | `string|null` | No |  |  |  | Yes | OpenLoop (Healthie) dietitian/org identifier that scopes openloop_patient_id |
| `openloop_patient_id` | `string|null` | No |  |  |  | Yes | OpenLoop (Healthie) patient/client identifier when this patient is linked to OpenLoop |
| `patient_id` | `string` | No | uuid |  |  | No | HealthCloud patient identifier (UUID). |
| `phones` | array of [`Phone`](./Phone.md) | No |  |  |  | No | Patient's phone numbers. |
| `photo_binary_id` | `string|null` | No |  |  |  | Yes | FHIR Binary resource ID of the most recent patient photo |
| `preferred_language` | `string` | No |  |  | `"en"` | No | BCP-47 language tag of the patient's preferred language. |
| `preferred_pharmacy` | [`PreferredPharmacy`](./PreferredPharmacy.md) | No |  |  |  | Yes | Patient's preferred pharmacy, when set. |
| `race` | array of [`Race`](./Race.md) | No |  |  |  | No | Patient's race(s); may include more than one. |
| `sex_at_birth` | [`SexAtBirth`](./SexAtBirth.md) | No |  |  |  | Yes | Sex assigned at birth: male, female, intersex, or unknown. |
| `steadymd_patient_guid` | `string|null` | No |  |  |  | Yes | SteadyMD patient guid when this patient is linked to SteadyMD |
| `steadymd_program_guid` | `string|null` | No |  |  |  | Yes | SteadyMD program guid that scopes steadymd_patient_guid |

## Example

None declared in canonical OpenAPI.