# LegalEntity
A legal entity. Legal entities are organizations, such as companies, that participate in financial transactions
## Example Usage
```typescript
import { LegalEntity } from "@apexfintechsolutions/ascend-sdk/models/components";
let value: LegalEntity = {};
```
## Fields
| Field | Type | Required | Description | Example |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accreditedInvestor` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is an accredited investor. By default, this is set to `false`. | false |
| `adviser` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is an adviser. By default, this is set to `false`. | false |
| `brokerDealer` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is a broker dealer. By default, this is set to `false`. | false |
| `businessIndustrialClassification` | [components.LegalEntityBusinessIndustrialClassification](../../models/components/legalentitybusinessindustrialclassification.md) | :heavy_minus_sign: | N/A | FINANCE_INSURANCE_AND_REAL_ESTATE |
| `clientEntityId` | *string* | :heavy_minus_sign: | An external identifier for the legal entity. This identifier does not have internal uniqueness constraints. | client-le-12345 |
| `corporateStructure` | [components.LegalEntityCorporateStructure](../../models/components/legalentitycorporatestructure.md) | :heavy_minus_sign: | Corporate structure of the entity. | CORPORATION_C_CORP |
| `correspondentId` | *string* | :heavy_minus_sign: | The correspondent id associated with the legal entity. | 01HPMZZM6RKMVZA1JQ63RQKJRP |
| `doingBusinessAs` | *string*[] | :heavy_minus_sign: | DBA (Doing Business As) names. Can list up to 5 associated with the Legal Entity | |
| `entityDueDiligence` | [components.EntityDueDiligence](../../models/components/entityduediligence.md) | :heavy_minus_sign: | Due Diligence for Legal Entities | |
| `entityName` | *string* | :heavy_minus_sign: | The legal entity name. | Acme, Inc |
| `entityType` | [components.LegalEntityEntityType](../../models/components/legalentityentitytype.md) | :heavy_minus_sign: | The entity type. | CORPORATION |
| `exemptCustomerReason` | [components.LegalEntityExemptCustomerReason](../../models/components/legalentityexemptcustomerreason.md) | :heavy_minus_sign: | **Field Dependencies:**
Exempt entities must set `exempt_verifying_beneficial_owners` to `true` and provide an `exempt_customer_reason` on the owner record.
Required if `exempt_verifying_beneficial_owners` is `true`.
Otherwise, must be empty. | NON_BANK_LISTED_ENTITY |
| `exemptVerifyingBeneficialOwners` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is exempt from verifying beneficial owners and Enhanced Due Diligence. By default, this is set to `false` | false |
| `forTheBenefitOf` | *string* | :heavy_minus_sign: | If the legal entity is a trust, they may set this field to convey ownership and value to a trustee. | John Dough |
| `foreignEntity` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is a foreign entity. By default, this is set to `false`. | false |
| `foreignFinancialInstitution` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is a foreign financial institution. By default, this is set to `false`. | false |
| `formationDate` | [components.FormationDate](../../models/components/formationdate.md) | :heavy_minus_sign: | If the legal entity is a trust, the formation date is required. | |
| `globalPersonId` | *string* | :heavy_minus_sign: | Globally Unique identifier for a legal natural person | 2F6C45338A9890F0F63093EBEE0C3E15764AEA87D4E0C8264EE79A3FA8E8C6E4 |
| `institutionalCustomer` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is an institutional customer. By default, this is set to `false`. | |
| `investigationId` | *string* | :heavy_minus_sign: | Investigation id relating to the Customer Identification Program (CIP) and Customer Due Diligence (CDD). | 01HXPXSFA4JMKVK1D3R1X75ZGZ |
| `largeTrader` | [components.LegalEntityLargeTrader](../../models/components/legalentitylargetrader.md) | :heavy_minus_sign: | Large trader for the legal entity. | |
| `legalAddress` | [components.LegalAddress](../../models/components/legaladdress.md) | :heavy_minus_sign: | The mailing address of the legal entity. Required fields within the `legal_address` object include:
- `administrative_area`
- `region_code` - 2 character CLDR Code
- `postal_code`
- `locality`
- `address_lines` - max 5 lines | |
| `legalEntityId` | *string* | :heavy_minus_sign: | A system-generated unique identifier referencing a single juridical (non-natural) person (e.g., a corporation); Used to access the record after creation | 42567868-9373-4872-9d24-2e33f6c19b75 |
| `leiCode` | *string* | :heavy_minus_sign: | The Legal Entity Identifier (LEI) is the financial industry term for a unique global identifier for legal entities participating in financial transactions | 12340012345678912372 |
| `name` | *string* | :heavy_minus_sign: | The name field Format: legalEntities/{legalEntity} | legalEntities/42567868-9373-4872-9d24-2e33f6c19b75 |
| `operatingRegions` | *string*[] | :heavy_minus_sign: | The operational footprint of an entity. Operating regions encompass all countries and regions where a company has a significant business presence This includes locations with physical offices, manufacturing plants, service centers, and sales and marketing activities Regions must be provided as two-character CLDR country codes | [
"US",
"CA"
] |
| `registrationRegion` | *string* | :heavy_minus_sign: | The legal home of an entity. A region of registration, in the context of a corporation, refers to the specific geographic area where the corporation is legally registered and incorporated Defines the legal jurisdiction and framework under which the corporation operates, including legal regulations, tax obligations, and compliance requirements Region must be provided as a two-character CLDR country code | US |
| `regulatedInvestmentCompany` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is a regulated investment company. By default, this is set to `false`. | false |
| `relatedDocumentIds` | *string*[] | :heavy_minus_sign: | Document ids related to the legal entity. At least one is required for RIA correspondents when creating Estate or Trust accounts. | [
"fb3f181c-f2fb-4bc2-b75a-79302c634ae5"
] |
| `revocableTrust` | *boolean* | :heavy_minus_sign: | Indicates whether the trust is a revocable trust. By default, this is set to `false`. | false |
| `taxId` | *string* | :heavy_minus_sign: | The full U.S. tax ID for a related entity; Must be provided with `EIN` 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.LegalEntityTaxIdType](../../models/components/legalentitytaxidtype.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.LegalEntityTaxProfile](../../models/components/legalentitytaxprofile.md) | :heavy_minus_sign: | The tax profile for the legal entity. | |