# Person
investigation details on a person
## Example Usage
```typescript
import { Person } from "@apexfintechsolutions/ascend-sdk/models/components";
let value: Person = {};
```
## Fields
| Field | Type | Required | Description | Example |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `birthDate` | [components.InvestigationBirthDate](../../models/components/investigationbirthdate.md) | :heavy_minus_sign: | The legal day, month, and year of birth for a natural person Must be formatted as an ISO-8601 YYYY-MM-DD | {
"day": 30,
"month": 9,
"year": 2023
} |
| `birthRegionCode` | *string* | :heavy_minus_sign: | Two character region code, complies with https://cldr.unicode.org/index Example values: "US", "CA" | US |
| `citizenshipRegionCodes` | *string*[] | :heavy_minus_sign: | The countries where a natural person retains citizenship; This is used for tax (treaty) and country block list considerations Two character region code, complies with https://cldr.unicode.org/index Example values: "US", "CA" | US |
| `documentIds` | *string*[] | :heavy_minus_sign: | Conditional: document_ids must be provided by the correspondent if InvestigationRequestScope = PERFORMED_BY_APEX and citizenship_country is not USA | 0f01ae1f-d24c-4171-8f3f-c0b820bf3044 |
| `emailAddresses` | *string*[] | :heavy_minus_sign: | Email addresses indicated for account communications | jdough@domain.com |
| `familyName` | *string* | :heavy_minus_sign: | Family name of a natural person | Dough |
| `givenName` | *string* | :heavy_minus_sign: | The given name of a natural person; Conventionally known as 'first name' in most English-speaking countries | John |
| `identifications` | [components.PersonIdentification](../../models/components/personidentification.md)[] | :heavy_minus_sign: | Identification details including id value, and type (e.g. ssn) | |
| `legalAddress` | [components.InvestigationPersonLegalAddress](../../models/components/investigationpersonlegaladdress.md) | :heavy_minus_sign: | legal address | |
| `mailingAddresses` | [components.PostalAddress](../../models/components/postaladdress.md)[] | :heavy_minus_sign: | mailing address | |
| `middleNames` | *string* | :heavy_minus_sign: | Middle names | Jacob |
| `nameSuffix` | [components.InvestigationNameSuffix](../../models/components/investigationnamesuffix.md) | :heavy_minus_sign: | The name suffix for individuals, one of:
- `NAME_SUFFIX_UNSPECIFIED` - Default/Null value.
- `SR` - Senior.
- `JR` - Junior.
- `III` - The third.
- `IV` - The fourth.
- `V` - The fifth. | JR |
| `phoneNumbers` | *string*[] | :heavy_minus_sign: | phone numbers related to this person | 214-765-1010 |
| `providedIdentityVerification` | [components.ProvidedIdentityVerification](../../models/components/providedidentityverification.md) | :heavy_minus_sign: | Conditional: Identity Verification results must be provided by the correspondent if InvestigationRequestScope = PROVIDED_BY_CLIENT | |