Core Person Data Model
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

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

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

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

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

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

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

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

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

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

Core Person Data ModelCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code