# Party

A single record representing an owner or manager of an Account. Contains fully populated Party Identity object.

## Example Usage

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

let value: Party = {};
```

## Fields

| Field                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Required                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `cftcDocumentDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                                   | [components.PartyCftcDocumentDeliveryPreference](../../models/components/partycftcdocumentdeliverypreference.md)                                                                                                                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for CFTC documents for a given Party record; Defaults to `DIGITAL` on futures account creation Only applies to CFTC regulated accounts                                                                                                                                                                                                                                                                                                 | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `emailAddress`                                                                                                                                                                                                                                                                                                                                                                                                                                                     | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | An email address indicated for account communications.                                                                                                                                                                                                                                                                                                                                                                                                             | example@domain.com                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `legalEntity`                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [components.PartyLegalEntity](../../models/components/partylegalentity.md)                                                                                                                                                                                                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Legal entity.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `legalNaturalPerson`                                                                                                                                                                                                                                                                                                                                                                                                                                               | [components.PartyLegalNaturalPerson](../../models/components/partylegalnaturalperson.md)                                                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Legal natural person.                                                                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `mailingAddress`                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [components.PartyMailingAddress](../../models/components/partymailingaddress.md)                                                                                                                                                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The object containing data for the purpose of delivery physical mailings to a party; Typically used for statements, account updates, tax documents, and other postal mailings; May also be used as an alternative identity verification address to personalAddress. Required fields within the `mailing_address` object include:<br/> - `administrative_area`<br/> - `region_code` - 2 character CLDR Code<br/> - `postal_code`<br/> - `locality`<br/> - `address_lines` - max 5 lines |                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `name`                                                                                                                                                                                                                                                                                                                                                                                                                                                             | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The name field Format: {parent=account/*}/{name=party/*}                                                                                                                                                                                                                                                                                                                                                                                                           | accounts/01HC3MAQ4DR9QN1V8MJ4CN1HMK/parties/a58ddb02-3954-4249-a7d5-1d408def12cf                                                                                                                                                                                                                                                                                                                                                                                   |
| `partyId`                                                                                                                                                                                                                                                                                                                                                                                                                                                          | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A system-generated unique identifier referencing a single owner or control person on an account; A Party contains account-specific information about a person whereas inside the Party is a reference to a reusable instance of a Person `legal_natural_person` or `legal_entity` which contains non-changing information about these persons; Used to access the record after creation                                                                            | a58ddb02-3954-4249-a7d5-1d408def12cf                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `phoneNumber`                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [components.PartyPhoneNumber](../../models/components/partyphonenumber.md)                                                                                                                                                                                                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The phone number for a party. Lives on the party record in the context of the account and does not commute to other accounts held by/for the person.                                                                                                                                                                                                                                                                                                               | 555-123-4567                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `prospectusDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                                     | [components.PartyProspectusDeliveryPreference](../../models/components/partyprospectusdeliverypreference.md)                                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for prospectuses for a given Party record; Can be `DIGITAL`, `PHYSICAL`, `SUPPRESS`; Defaults to `DIGITAL` on account creation but may be updated                                                                                                                                                                                                                                                                                      | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `proxyDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                                          | [components.PartyProxyDeliveryPreference](../../models/components/partyproxydeliverypreference.md)                                                                                                                                                                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for proxy voting for a given Party record; Can be `DIGITAL`, `PHYSICAL`, `SUPPRESS`; Defaults to `DIGITAL` on account creation but may be updated                                                                                                                                                                                                                                                                                      | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `relationType`                                                                                                                                                                                                                                                                                                                                                                                                                                                     | [components.PartyRelationType](../../models/components/partyrelationtype.md)                                                                                                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Conveys how a person is related to account; Located on each account Party record; Examples are `PRIMARY_OWNER`, `JOINT_OWNER`, `EXECUTOR`, etc.                                                                                                                                                                                                                                                                                                                    | PRIMARY_OWNER                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `statementDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                                      | [components.PartyStatementDeliveryPreference](../../models/components/partystatementdeliverypreference.md)                                                                                                                                                                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for account statements for a given Party record; Can be `DIGITAL`, `PHYSICAL`, `SUPPRESS`; Defaults to `DIGITAL` on account creation but may be updated                                                                                                                                                                                                                                                                                | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `taxDocumentDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                                    | [components.PartyTaxDocumentDeliveryPreference](../../models/components/partytaxdocumentdeliverypreference.md)                                                                                                                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for tax documents for a given Party record; Can be `DIGITAL`, `PHYSICAL`, `SUPPRESS`; Defaults to `DIGITAL` on account creation but may be updated; Per regulation, selected tax forms will be mailed by regulation regardless of this setting                                                                                                                                                                                         | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `tradeConfirmationDeliveryPreference`                                                                                                                                                                                                                                                                                                                                                                                                                              | [components.PartyTradeConfirmationDeliveryPreference](../../models/components/partytradeconfirmationdeliverypreference.md)                                                                                                                                                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Delivery method instruction for trade confirmations for a given Party record; Can be `DIGITAL`, `PHYSICAL`, `SUPPRESS`; Defaults to `DIGITAL` on account creation but may be updated                                                                                                                                                                                                                                                                               | DIGITAL                                                                                                                                                                                                                                                                                                                                                                                                                                                            |