<!-- https://staircase.co/data/property/person -->
# person

# person

An individual: name, demographics, identification, citizenship and the biographical detail the source records.

<!--source:property-registry-->
Represents an individual person with comprehensive personal information including name, demographics, identification, citizenship status, and biographical details.
<!--/source-->

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.

Other classes answering this question

## 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` | <!--source:property-registry-->HTTP request configuration for retrieving this data.<!--/source--> |
| `request_identifier` | `string | null` | <!--source:property-registry-->Identifier value that should be substituted into the source HTTP request to retrieve this specific data.<!--/source--> |
| `birth_date` | `string | null` | <!--source:property-registry-->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.<!--/source--> |
| `first_name` | `string` | <!--source:property-registry-->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.<!--/source--> |
| `last_name` | `string` | <!--source:property-registry-->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.<!--/source--> |
| `middle_name` | `string | null` | <!--source:property-registry-->The middle name of the individual represented by the parent object<!--/source--> |
| `prefix_name` | `string | null` | <!--source:property-registry-->Common honorifics or titles preceding names. Adjust this list based on cultural or domain-specific requirements. `Mr.``Mrs.``Ms.``Miss``Mx.``Dr.``Prof.``Rev.``Fr.``Sr.``Br.``Capt.``Col.``Maj.``Lt.``Sgt.``Hon.``Judge``Rabbi``Imam``Sheikh``Sir``Dame`<!--/source--> |
| `suffix_name` | `string | null` | <!--source:property-registry-->Suffixes typically denote generational titles, academic degrees, or professional certifications. `Jr.``Sr.``II``III``IV``PhD``MD``Esq.``JD``LLM``MBA``RN``DDS``DVM``CFA``CPA``PE``PMP``Esq.``Emeritus``Ret.`<!--/source--> |
| `us_citizenship_status` | `string | null` | <!--source:property-registry-->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. `NonPermanentResidentAlien``NonPermResidentAlien``PermResidentAlien``PermanentResidentAlien``USCitizenAbroad``USCitizen``ForeignNational`<!--/source--> |
| `veteran_status` | `boolean | null` | <!--source:property-registry-->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.<!--/source--> |

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

How a new jurisdiction is brought online
