# LegalNaturalPerson

A legal natural person. This represents the full set of data for an individual. A Customer Identification Program (CIP) may be run on legal natural persons.

## Example Usage

```typescript
import { LegalNaturalPerson } from "@apexfintechsolutions/ascend-sdk/models/components";

let value: LegalNaturalPerson = {};
```

## Fields

| Field                                                                                                                                                                                                                                                                                                                                           | Type                                                                                                                                                                                                                                                                                                                                            | Required                                                                                                                                                                                                                                                                                                                                        | Description                                                                                                                                                                                                                                                                                                                                     | Example                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accreditedInvestor`                                                                                                                                                                                                                                                                                                                            | *boolean*                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Indicates whether the person is an accredited investor. By default, this is set to `false`.                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                 |
| `adviser`                                                                                                                                                                                                                                                                                                                                       | *boolean*                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Indicates whether the person is an adviser. By default, this is set to `false`.                                                                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                 |
| `birthDate`                                                                                                                                                                                                                                                                                                                                     | [components.BirthDate](../../models/components/birthdate.md)                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The legal day, month, and year of birth for a natural person.                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                 |
| `citizenshipCountries`                                                                                                                                                                                                                                                                                                                          | *string*[]                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | This is used for tax (treaty) and country block list considerations Maximum list of two 2-char CLDR Code citizenship countries, e.g. US, CA                                                                                                                                                                                                     | [<br/>"US",<br/>"CA"<br/>]                                                                                                                                                                                                                                                                                                                      |
| `clientPersonId`                                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | An external identifier for the legal natural person. This identifier does not have internal uniqueness constraints.                                                                                                                                                                                                                             | client-lnp-12345                                                                                                                                                                                                                                                                                                                                |
| `controlPersonCompanySymbols`                                                                                                                                                                                                                                                                                                                   | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A list of ticker symbols in which the underlying person is a control person; control persons are defined as having significant influence over a company’s management and operations, typically through ownership of a large percentage of the company’s voting stock or through positions on the company’s board of directors or executive team | AAPL, GOOL                                                                                                                                                                                                                                                                                                                                      |
| `correspondentEmployee`                                                                                                                                                                                                                                                                                                                         | *boolean*                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Indicates the related owner record is an employee of the clearing broker's correspondent customer. By default, this is set to `false`.                                                                                                                                                                                                          | false                                                                                                                                                                                                                                                                                                                                           |
| `correspondentId`                                                                                                                                                                                                                                                                                                                               | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A unique identifier referencing a Correspondent; A Client may have several operating Correspondents within its purview.                                                                                                                                                                                                                         | 01HPMZZM6RKMVZA1JQ63RQKJRP                                                                                                                                                                                                                                                                                                                      |
| `custodianEmployee`                                                                                                                                                                                                                                                                                                                             | *boolean*                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A flag to indicate whether this person is an employee of the correspondent. By default, this is set to `false`.                                                                                                                                                                                                                                 | false                                                                                                                                                                                                                                                                                                                                           |
| `customerIdentificationId`                                                                                                                                                                                                                                                                                                                      | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Customer identification id returned by the customer identification service which represents a single instance of an identity verification outcome for the specified customer. This verification result will be used as part of the full investigation.                                                                                          | 01HXPXSFA4JMKVK1D3R1X75ZGX                                                                                                                                                                                                                                                                                                                      |
| `deathDate`                                                                                                                                                                                                                                                                                                                                     | [components.DeathDate](../../models/components/deathdate.md)                                                                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The day, month, and year of death of a legal natural person                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                 |
| `doingBusinessAs`                                                                                                                                                                                                                                                                                                                               | *string*[]                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | DBA (Doing Business As) names. Can list up to 5 associated with the Legal Natural Person                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                 |
| `employment`                                                                                                                                                                                                                                                                                                                                    | [components.Employment](../../models/components/employment.md)                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Object containing information pertaining to a investor's current employer including the name, address, and duration of employment.                                                                                                                                                                                                              |                                                                                                                                                                                                                                                                                                                                                 |
| `familyName`                                                                                                                                                                                                                                                                                                                                    | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Family name of a natural person.                                                                                                                                                                                                                                                                                                                | Doe                                                                                                                                                                                                                                                                                                                                             |
| `finraAssociatedEntity`                                                                                                                                                                                                                                                                                                                         | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The name of the FINRA-associated entity the underlying natural person is affiliated with.                                                                                                                                                                                                                                                       | Entity Name                                                                                                                                                                                                                                                                                                                                     |
| `foreignIdentification`                                                                                                                                                                                                                                                                                                                         | [components.ForeignIdentification](../../models/components/foreignidentification.md)                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | **Field Dependencies:**<br/><br/>Required if `irs_form_type` is `W_8BEN`.<br/><br/>Otherwise, must be empty.                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                 |
| `givenName`                                                                                                                                                                                                                                                                                                                                     | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The given name of a natural person; Conventionally known as 'first name' in most English-speaking countries.                                                                                                                                                                                                                                    | John                                                                                                                                                                                                                                                                                                                                            |
| `globalPersonId`                                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Globally Unique identifier for a legal natural person                                                                                                                                                                                                                                                                                           | 0B4127F7C8C9DD8F4A33FEE7E3C2C620814B9AA0369BDECD0A02556F49D79C22                                                                                                                                                                                                                                                                                |
| `identityVerificationResult`                                                                                                                                                                                                                                                                                                                    | [components.LegalNaturalPersonIdentityVerificationResult](../../models/components/legalnaturalpersonidentityverificationresult.md)                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Third-party data result used to verify the identity of an introduced investor. If the client identity_verification_model is PROVIDED_BY_CLIENT, this field is required                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                 |
| `institutionalCustomer`                                                                                                                                                                                                                                                                                                                         | *boolean*                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Indicates whether the person is an institutional customer. By default, this is set to `false`.                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                 |
| `investigationId`                                                                                                                                                                                                                                                                                                                               | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Investigation id relating a comprehensive investigation for a customer, encompassing the aggregation of identity verification results and watchlist screenings, conducted to support the Customer Identification Program (CIP) and Customer Due Diligence (CDD)                                                                                 | 01HXPXSFA4JMKVK1D3R1X75ZGZ                                                                                                                                                                                                                                                                                                                      |
| `largeTrader`                                                                                                                                                                                                                                                                                                                                   | [components.LegalNaturalPersonLargeTrader](../../models/components/legalnaturalpersonlargetrader.md)                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Indicates if the person is recognized as a "Large Trader" by the SEC.                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                 |
| `legalNaturalPersonId`                                                                                                                                                                                                                                                                                                                          | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A system-generated unique identifier referencing a single natural person; Used to access the record after creation.                                                                                                                                                                                                                             | e6716139-da77-46d1-9f15-13599161db0b                                                                                                                                                                                                                                                                                                            |
| `maritalStatus`                                                                                                                                                                                                                                                                                                                                 | [components.LegalNaturalPersonMaritalStatus](../../models/components/legalnaturalpersonmaritalstatus.md)                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The legal marital status of an account-holder; Used in combination with state of domicile to determine qualification for account types and beneficiary exclusion rules.                                                                                                                                                                         | SINGLE                                                                                                                                                                                                                                                                                                                                          |
| `middleNames`                                                                                                                                                                                                                                                                                                                                   | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Non-primary names representing a natural person; Name attributed to a person other than "Given" and "Family" names.                                                                                                                                                                                                                             | Smith                                                                                                                                                                                                                                                                                                                                           |
| `name`                                                                                                                                                                                                                                                                                                                                          | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The name field Format: legalNaturalPersons/{legalNaturalPerson}                                                                                                                                                                                                                                                                                 | legalNaturalPersons/e6716139-da77-46d1-9f15-13599161db0b                                                                                                                                                                                                                                                                                        |
| `nameSuffix`                                                                                                                                                                                                                                                                                                                                    | [components.LegalNaturalPersonNameSuffix](../../models/components/legalnaturalpersonnamesuffix.md)                                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The suffix of a natural person; A suffix in a name is any part of the name that comes after the last name                                                                                                                                                                                                                                       | JR                                                                                                                                                                                                                                                                                                                                              |
| `naturalPersonFdd`                                                                                                                                                                                                                                                                                                                              | [components.NaturalPersonFdd](../../models/components/naturalpersonfdd.md)                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Foreign Due Diligence (FDD) information for Legal Natural Person                                                                                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                 |
| `nonCitizenResidency`                                                                                                                                                                                                                                                                                                                           | [components.NonCitizenResidency](../../models/components/noncitizenresidency.md)                                                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Facilitates non-citizen lawful US residents to open domestic accounts                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                 |
| `personalAddress`                                                                                                                                                                                                                                                                                                                               | [components.PersonalAddress](../../models/components/personaladdress.md)                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The legal street number and street name for an account Party. Required fields within the `personal_address` object include:<br/> - `administrative_area`<br/> - `region_code` - 2 character CLDR Code<br/> - `postal_code`<br/> - `locality`<br/> - `address_lines` - max 5 lines                                                               |                                                                                                                                                                                                                                                                                                                                                 |
| `politicallyExposedImmediateFamilyNames`                                                                                                                                                                                                                                                                                                        | *string*[]                                                                                                                                                                                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A Party's self-disclosed list of names representing family members who are politically exposed.                                                                                                                                                                                                                                                 | [<br/>"Sue Doe"<br/>]                                                                                                                                                                                                                                                                                                                           |
| `politicallyExposedOrganization`                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | A Party's self-disclosed list of named politically exposed organizations they are personally associated with.                                                                                                                                                                                                                                   | PEAK6, Apex Clearing                                                                                                                                                                                                                                                                                                                            |
| `taxId`                                                                                                                                                                                                                                                                                                                                         | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The full U.S. tax ID for a related person; Must be provided with `ITIN` or `SSN` tax ID type                                                                                                                                                                                                                                                    | 987-65-4321                                                                                                                                                                                                                                                                                                                                     |
| `taxIdLastFour`                                                                                                                                                                                                                                                                                                                                 | *string*                                                                                                                                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The last four characters of the related person's tax identifier; Masked/truncated to "last four" in most usage contexts to preserve data privacy.                                                                                                                                                                                               | 6789                                                                                                                                                                                                                                                                                                                                            |
| `taxIdType`                                                                                                                                                                                                                                                                                                                                     | [components.LegalNaturalPersonTaxIdType](../../models/components/legalnaturalpersontaxidtype.md)                                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | The nature of the U.S. Tax ID indicated in the related tax_id field; Examples include ITIN, SSN, EIN.                                                                                                                                                                                                                                           | SSN                                                                                                                                                                                                                                                                                                                                             |
| `taxProfile`                                                                                                                                                                                                                                                                                                                                    | [components.TaxProfile](../../models/components/taxprofile.md)                                                                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                              | Tax-related attributes at the for the account; A tax profile with taxpayer attributes is located on the legal_natural_person or legal_entity objects elsewhere on the account record.                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                 |