# CashDividend

Used to record the distribution of cash to shareholders, paid by the issuer, usually based upon current earnings and/or accumulated profits as declared by the board of directors and details related to the cash dividend

## Example Usage

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

let value: CashDividend = {};
```

## Fields

| Field                                                                                                                                                                                                                                                                | Type                                                                                                                                                                                                                                                                 | Required                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                                                          | Example                                                                                                                                                                                                                                                              |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cashRate`                                                                                                                                                                                                                                                           | [components.EntryCashDividendCashRate](../../models/components/entrycashdividendcashrate.md)                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                   | The rate (raw value, not a percentage, example: 50% will be .5 in this field) at which cash will be disbursed to the shareholder                                                                                                                                     | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                                                                          |
| `corporateActionGeneralInformation`                                                                                                                                                                                                                                  | [components.EntryCashDividendCorporateActionGeneralInformation](../../models/components/entrycashdividendcorporateactiongeneralinformation.md)                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Common fields for corporate actions                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                      |
| `fpsl`                                                                                                                                                                                                                                                               | [components.EntryFpsl](../../models/components/entryfpsl.md)                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Corresponds to the raw bucket value that denotes a position is allocated to the "fpsl" memo location                                                                                                                                                                 | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                                                                          |
| `free`                                                                                                                                                                                                                                                               | [components.EntryFree](../../models/components/entryfree.md)                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Corresponds to the raw bucket value that denotes a position is allocated to the "free" memo location                                                                                                                                                                 | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                                                                          |
| `longTermGain`                                                                                                                                                                                                                                                       | *boolean*                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Corresponds to corporateactions.announcement.capital_gains                                                                                                                                                                                                           | false                                                                                                                                                                                                                                                                |
| `paymentDate`                                                                                                                                                                                                                                                        | [components.EntryCashDividendPaymentDate](../../models/components/entrycashdividendpaymentdate.md)                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                   | The anticipated payment date at the depository                                                                                                                                                                                                                       | {<br/>"day": 14,<br/>"month": 5,<br/>"year": 2024<br/>}                                                                                                                                                                                                              |
| `qualified`                                                                                                                                                                                                                                                          | *boolean*                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Identifies whether dividend income is potentially qualified for the lower maximum individual federal tax rate under the Jobs and Growth Tax Relief Reconciliation Act of 2003                                                                                        | false                                                                                                                                                                                                                                                                |
| `quantity`                                                                                                                                                                                                                                                           | [components.EntryCashDividendQuantity](../../models/components/entrycashdividendquantity.md)                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                                                                                   | When ex-date occurs before the record date, quantity will equal the settled date position balance on the position date of the event When ex-date occurs after the record date, quantity will equal the trade date position balance on the position date of the event | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                                                                          |
| `recordDate`                                                                                                                                                                                                                                                         | [components.EntryRecordDate](../../models/components/entryrecorddate.md)                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                   | The date on which positions are recorded in order to calculate entitlement                                                                                                                                                                                           | {<br/>"day": 14,<br/>"month": 5,<br/>"year": 2024<br/>}                                                                                                                                                                                                              |
| `reinvested`                                                                                                                                                                                                                                                         | *boolean*                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Indicates whether the cash dividend was reinvested                                                                                                                                                                                                                   | false                                                                                                                                                                                                                                                                |
| `settled`                                                                                                                                                                                                                                                            | [components.EntryCashDividendSettled](../../models/components/entrycashdividendsettled.md)                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Corresponds to the position's settled quantity                                                                                                                                                                                                                       | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                                                                          |
| `substitutePayment`                                                                                                                                                                                                                                                  | *boolean*                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Indicates whether the corporate action event is a substitute payment                                                                                                                                                                                                 | false                                                                                                                                                                                                                                                                |
| `subtype`                                                                                                                                                                                                                                                            | [components.Subtype](../../models/components/subtype.md)                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                                   | Corresponds to the subtype of corporaction type                                                                                                                                                                                                                      | LIQUIDATION                                                                                                                                                                                                                                                          |