person
An individual: name, demographics, identification, citizenship and the biographical detail the source records.
Represents an individual person with comprehensive personal information including name, demographics, identification, citizenship status, and biographical details.
The question it answers
Who owns it, and what does that imply?
A deed names its parties as strings. Resolving those strings to a person and a mailing address is what separates an owner-occupant from an investor, and what links one owner to the rest of a portfolio.
Why it matters
Ownership is the question this class exists to answer. A deed names parties as strings, and turning those strings into people is what separates an owner-occupant from an investor and links one owner to the rest of a portfolio.
In practice
Name parsing is the work. County records are upper case, comma-ordered, inconsistently suffixed, and carry markers that are not part of a name — trustee abbreviations, estate markers, and a deceased marker among them. The normaliser carries checked-in vocabularies for suffixes, surname prefixes and company keywords, and the presence of a deceased marker and a trustee abbreviation in those lists is the sign they were written against real deed data rather than invented.
The first decision is whether a party string is a person at all, because the same field carries both individuals and entities.
Properties
| Property | Type | Definition |
|---|---|---|
source_http_request | object | HTTP request configuration for retrieving this data. |
request_identifier | string | null | Identifier value that should be substituted into the source HTTP request to retrieve this specific data. |
birth_date | string | null | A birth date is the date on which a person was born. It typically includes the day, month, and year of an individual's birth and is used to determine their age. |
first_name | string | A person's first name is the name that they are given at birth or during infancy, and it is typically used to identify them in a personal or informal context. |
last_name | string | A person's last name, also known as surname or family name, is typically the name that is shared by all members of their immediate family. |
middle_name | string | null | The middle name of the individual represented by the parent object |
prefix_name | string | null | Common honorifics or titles preceding names. Adjust this list based on cultural or domain-specific requirements. Mr.Mrs.Ms.MissMx.Dr.Prof.Rev.Fr.Sr.Br.Capt.Col.Maj.Lt.Sgt.Hon.JudgeRabbiImamSheikhSirDame |
suffix_name | string | null | Suffixes typically denote generational titles, academic degrees, or professional certifications. Jr.Sr.IIIIIIVPhDMDEsq.JDLLMMBARNDDSDVMCFACPAPEPMPEsq.EmeritusRet. |
us_citizenship_status | string | null | Citizenship status refers to an individual's legal status as a citizen or non-citizen of a country. In the United States, citizenship status is determined by birthright, naturalization, or other legal means. NonPermanentResidentAlienNonPermResidentAlienPermResidentAlienPermanentResidentAlienUSCitizenAbroadUSCitizenForeignNational |
veteran_status | boolean | null | Veteran status refers to an individual's status as a former member of the armed forces. In the United States, a person is considered a veteran if they have served in the active military, naval, or air service and were discharged or released from that service under conditions other than dishonorable. |
Provenance and coverage
A record of this class is validated against the same definition whatever jurisdiction it came from, which is what makes two counties comparable without a per-county adapter. A jurisdiction appears below only where a committed configuration serves this class's surface.
- Lee, Florida
- Palm Beach, Florida
- Miami-Dade, Florida
- Orange, Florida
- Santa Clara, California