# Core Person Data Model

## Overview

The **Core Person** domain represents the canonical, non-clinical representation of an individual human being in Verato. This domain captures foundational demographic, contact, identity, and preference information that is broadly applicable across industries and use cases. It serves as the **base domain** for the **Person** entity and is extended by more specialized domains (for example, **Patient**).

## When to Use This Domain

### Use the Core Person domain when:

* You need a general representation of a person independent of healthcare delivery
* You want to manage demographic, contact, or preference data that is not specific to a clinical workflow


### Do not use this domain when:

* Clinical, encounter-level, or healthcare-specific attributes are required (use the **Patient** domain instead)


## Relationship to Other Domains

| Attribute | Relationship |
|  --- | --- |
| **Base domain for:** | All domains created for the Person entity |
| **Shares Identity With:** | All Person domains |


The **Core Person** domain represents the canonical, non-clinical representation of an individual in Verato. Domain extensions may be introduced for specialized organizational contexts in the future.

## Data Model

The **Core Person** schema is composed of multiple repeatable attribute groups. All attributes are optional unless otherwise noted.

### Addresses

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `type` | Code Set | Address Type (home, work, personal, etc...) |
|  | `line1` | Text | Primary street address or location line |
|  | `line2` | Text | Secondary address details like suite or floor number |
|  | `city` | Text | City of the address |
|  | `district` | Text | Administrative division within a state or city |
|  | `state` | Text | State or province of the address |
|  | `postalCode` | Text | ZIP or postal code used for mailing |
|  | `country` | Text | Country where the person is located |
|  | `latitude` | Number | Latitude coordinate |
|  | `longitude` | Number | Longitude coordinate |
|  | `validFrom` | Date | The date from which this data is considered valid |
|  | `validTo` | Date | The date after which this data is considered invalid |


### Alternate Identifiers

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `description` | Text | Textual description providing details about the item |
|  | `type` | Code Set | Category or classification for the given field |
|  | `value` | Text | Field representing value |
|  | `status` | Text | Current status, such as active or inactive |
|  | `issuer` | Text | Entity that issued the identifier or document |
|  | `issueDate` | Date | Date on which the document or identifier was issued |
|  | `startDate` | Date | Date marking the beginning of a period or validity |
|  | `endDate` | Date | Date marking the end of a period or validity |


### Citizenships

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `citizenship` | Code Set | Country of citizenship |


### Communication Languages

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `language` | Code Set | Spoken language code |
|  | `preferred` | Boolean | Flag indicating preferred option |


### Consent

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `name` | Text | Name of a preference, consent, or policy |
|  | `type` | Code Set | Category or classification of the consent |
|  | `status` | Code Set | Current status, such as active or inactive |
|  | `isRequired` | Boolean | Indicates if consent is required |
|  | `decision` | Code Set | Consent decision (e.g., granted, denied) |
|  | `validFrom` | Date | The date from which this consent is considered valid |
|  | `validTo` | Date | The date after which this consent is considered invalid |
|  | `source` | Text | Source from which the data was collected |
|  | `regulatoryBasis` | Code Set | Legal or policy justification code |


### Dates Of Birth

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `dateOfBirth` | Date | Date of birth of the person |
| **Death Details** |  |  |  |
| **Death Details** | `deceased` | Code Set | Field representing deceased |
| **Death Details** | `dateOfDeath` | Date-Time | Date and time of death |
| **Death Details** | `city` | Text | City where the person was deceased |
| **Death Details** | `county` | Text | County or administrative division where the person was deceased |
| **Death Details** | `state` | Text | State or province where the person was deceased |
| **Death Details** | `country` | Text | Country where the person was deceased |


### Emails

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `type` | Code Set | Code indicating the kind or category (e.g., home, work) |
|  | `email` | Text | Email address for communication |
|  | `validFrom` | Date | The date from which this email is considered valid |
|  | `validTo` | Date | The date after which this email is considered invalid |


### Ethnicities

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `ethnicity` | Code Set | Ethnic group classification |


### External Unique Identifier

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `issuer` | Text | Entity that issued the identifier or document |
|  | `value` | Text | Value of the identifier |
|  | `status` | Text | Current status, such as active or inactive |
|  | `startDate` | Date | Date marking the beginning of a period or validity |
|  | `endDate` | Date | Date marking the end of a period or validity |


### Gender Identities

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `genderIdentity` | Code Set | Self-identified gender representation |


### Genders

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `gender` | Code Set | Sex assigned at birth |


### Marital Statuses

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `maritalStatus` | Code Set | Marital status |


### Multiple Birth Indicator

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `multipleBirthIndicator` | Boolean | Boolean for multiple birth status |
|  | `multipleBirthInteger` | Number | Person's number in birth order (e.g., 2 for twin #2) |
|  | `birthPlurality` | Number | Total number of siblings in the birth (e.g., 2 for twins) |


### Names

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `use` | Code Set | Usage context for the name (e.g., official, nickname) |
|  | `prefix` | Text | Honorific prefix (e.g., Dr., Mr., Ms.) |
|  | `first` | Text | First name |
|  | `middle` | Text | Middle name or initial |
|  | `last` | Text | Last name or surname |
|  | `suffix` | Text | Suffix such as Jr., Sr., III |
|  | `credential` | Text | Professional credential or designation |


### Phone Numbers

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `type` | Code Set | Phone Type (home, work, personal, etc...) |
|  | `countryCode` | Text | Field representing countryCode |
|  | `areaCode` | Text | Field representing areaCode |
|  | `number` | Text | Field representing number |
|  | `extension` | Text | Field representing extension |
|  | `validTo` | Date | The date after which this phone is considered invalid |
|  | `validFrom` | Date | The date from which this phone is considered valid |
| **Best Time to Contact** |  |  |  |
| **Best Time to Contact** | `day` | Code Set | Day of the week |
| **Best Time to Contact** | `startTime` | Time | Time contact is preferred to begin |
| **Best Time to Contact** | `endTime` | Time | Time contact is preferred to end |
| **Best Time to Contact** | `allDay` | Boolean | Boolean for all-day availability |


### Photos

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `url` | Text | Web address for image or photo |


### Preferences

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `name` | Text | Name of a preference |
|  | `type` | Text | Type of preference |
| **Channels** |  |  |  |
| **Channels** | `type` | Code Set | Type of communication channel (e.g., SMS, Email, Phone) |
|  | `isOptedIn` | Boolean | Indicates whether the person has opted in to receive communications |
|  | `lastOptedInDate` | Date | The most recent date the person opted in to the selected communication type |
|  | `frequency` | Text | How often the person prefers to be contacted (e.g., weekly, monthly) |
|  | `preferredStartTime` | Time | The earliest preferred time of day for communication |
|  | `preferredEndTime` | Time | The latest preferred time of day for communication |


### Qualifications

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `type` | Code Set | Type of qualification (qualification, ceritfication etc.) |
|  | `qualification` | Code Set | Qualification or certificate obtained |
|  | `status` | Code Set | Current status, such as active or inactive |
|  | `issuer` | Text | Entity that issued the identifier or document |
|  | `issueDate` | Date | Date on which the document or identifier was issued |
|  | `validFrom` | Date | The date from which this qualification is considered valid |
|  | `validTo` | Date | The date after which this qualification is considered invalid |


### Races

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `race` | Code Set | Race or racial identity |


### Religious Affiliations

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `religiousAffiliation` | Code Set | Religious belief or affiliation |


### SSNs

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `ssn` | Text | Social Security Number |


### Sexual Orientations

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `sexualOrientation` | Code Set | Self-declared sexual orientation |