# LegalEntityCreate
A legal entity. Legal entities are organizations, such as companies, that participate in financial transactions
## Example Usage
```typescript
import {
EntityType,
FederalTaxClassification,
IrsFormType,
LegalEntityCreate,
LegalEntityCreateTaxIdType,
UsTinStatus,
} from "@apexfintechsolutions/ascend-sdk/models/components";
let value: LegalEntityCreate = {
correspondentId: "01HPMZZM6RKMVZA1JQ63RQKJRP",
entityName: "Acme, Inc",
entityType: EntityType.Corporation,
legalAddress: {},
operatingRegions: [
"US",
"CA",
],
registrationRegion: "US",
taxId: "987-65-4321",
taxIdType: LegalEntityCreateTaxIdType.TaxIdTypeSsn,
taxProfile: {
federalTaxClassification: FederalTaxClassification.CCorporation,
irsFormType: IrsFormType.W9,
legalTaxRegionCode: "US",
usTinStatus: UsTinStatus.Passing,
},
};
```
## 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.BusinessIndustrialClassification](../../models/components/businessindustrialclassification.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.CorporateStructure](../../models/components/corporatestructure.md) | :heavy_minus_sign: | Corporate structure of the entity. | CORPORATION_C_CORP |
| `correspondentId` | *string* | :heavy_check_mark: | 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.EntityDueDiligenceCreate](../../models/components/entityduediligencecreate.md) | :heavy_minus_sign: | Due Diligence for Legal Entities required when a Legal Entity is the Primary Owner on an Account. | |
| `entityName` | *string* | :heavy_check_mark: | The legal entity name. | Acme, Inc |
| `entityType` | [components.EntityType](../../models/components/entitytype.md) | :heavy_check_mark: | The entity type. | CORPORATION |
| `exemptCustomerReason` | [components.ExemptCustomerReason](../../models/components/exemptcustomerreason.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 |
| `foreignFinancialInstitution` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is a foreign financial institution. By default, this is set to `false`. | false |
| `formationDate` | [components.DateCreate](../../models/components/datecreate.md) | :heavy_minus_sign: | Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:
* A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date
Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and `google.protobuf.Timestamp`. | |
| `institutionalCustomer` | *boolean* | :heavy_minus_sign: | Indicates whether the entity is an institutional customer. By default, this is set to `false`. | |
| `largeTrader` | [components.LargeTraderCreate](../../models/components/largetradercreate.md) | :heavy_minus_sign: | A large trader. | |
| `legalAddress` | [components.PostalAddressCreate](../../models/components/postaladdresscreate.md) | :heavy_check_mark: | Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains).
In typical usage an address would be created via user input or from importing existing data, depending on the type of process.
Advice on address input / editing: - Use an i18n-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used.
For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478 | |
| `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 |
| `operatingRegions` | *string*[] | :heavy_check_mark: | 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_check_mark: | 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 |
| `subjectToBackupWithholding` | *boolean* | :heavy_minus_sign: | Boolean indicator whether the LE is subject to backup withholding. By default, this is set to `false`. | false |
| `taxId` | *string* | :heavy_check_mark: | The full U.S. tax ID for a related entity; Must be provided with `EIN` tax ID type | 987-65-4321 |
| `taxIdType` | [components.LegalEntityCreateTaxIdType](../../models/components/legalentitycreatetaxidtype.md) | :heavy_check_mark: | The nature of the U.S. Tax ID indicated in the related tax_id field; Examples include ITIN, SSN, EIN. | SSN |
| `taxProfile` | [components.TaxProfileCreate](../../models/components/taxprofilecreate.md) | :heavy_check_mark: | Tax Profile pertaining to the Legal Entity or Natural Person. | |