> For the complete documentation index, see [llms.txt](https://developers.polymath.network/polymesh-sdk-api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md).

# DividendDistribution

Represents a Corporate Action via which a Security Token issuer wishes to distribute dividends between a subset of the Tokenholders (targets)

## Hierarchy

↳ [CorporateAction](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)

↳ **DividendDistribution**

## Index

### Properties

* [claim](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#claim)
* [context](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#protected-context)
* [currency](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#currency)
* [declarationDate](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#declarationdate)
* [defaultTaxWithholding](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#defaulttaxwithholding)
* [description](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#description)
* [expiryDate](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#expirydate)
* [id](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#id)
* [kind](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#protected-kind)
* [linkDocuments](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#linkdocuments)
* [maxAmount](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#maxamount)
* [modifyCheckpoint](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#modifycheckpoint)
* [origin](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#origin)
* [pay](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#pay)
* [paymentDate](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#paymentdate)
* [perShare](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#pershare)
* [reclaimFunds](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#reclaimfunds)
* [targets](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#targets)
* [taxWithholdings](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#taxwithholdings)
* [ticker](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#ticker)
* [uuid](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#uuid)

### Methods

* [checkpoint](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#checkpoint)
* [details](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#details)
* [exists](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#exists)
* [getParticipants](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#getparticipants)
* [getWithheldTax](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#getwithheldtax)
* [isEqual](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#isequal)
* [generateUuid](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#static-generateuuid)
* [unserialize](/polymesh-sdk-api-reference/docs-v5/classes/dividenddistribution.md#static-unserialize)

## Properties

### claim

• **claim**: *ProcedureMethod‹void, void›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:154*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L154)

Claim the dividends corresponding to the current Identity

### `Protected` context

• **context**: [*Context*](/polymesh-sdk-api-reference/docs-v5/classes/context.md)

*Inherited from* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*.*[*context*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md#protected-context)

*Defined in* [*src/api/entities/Entity.ts:48*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/Entity.ts#L48)

### currency

• **currency**: *string*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:70*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L70)

ticker of the currency in which dividends are being distibuted

### declarationDate

• **declarationDate**: *Date*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*declarationDate*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#declarationdate)

*Defined in* [*src/api/entities/CorporateAction/index.ts:70*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L70)

date at which the Corporate Action was created

### defaultTaxWithholding

• **defaultTaxWithholding**: *BigNumber*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*defaultTaxWithholding*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#defaulttaxwithholding)

*Defined in* [*src/api/entities/CorporateAction/index.ts:86*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L86)

default percentage of tax withholding for this Corporate Action

### description

• **description**: *string*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*description*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#description)

*Defined in* [*src/api/entities/CorporateAction/index.ts:75*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L75)

brief text description of the Corporate Action

### expiryDate

• **expiryDate**: *null | Date*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:86*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L86)

date after which dividends can no longer be paid/reclaimed. A null value means the distribution never expires

### id

• **id**: *BigNumber*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*id*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#id)

*Defined in* [*src/api/entities/CorporateAction/index.ts:60*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L60)

internal Corporate Action ID

### `Protected` kind

• **kind**: [*UnpredictableBenefit*](/polymesh-sdk-api-reference/docs-v5/enums/corporateactionkind.md#unpredictablebenefit)

*Overrides* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*kind*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#protected-kind)

*Defined in* [*src/api/entities/DividendDistribution/index.ts:93*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L93)

### linkDocuments

• **linkDocuments**: *ProcedureMethod‹*[*LinkCaDocsParams*](/polymesh-sdk-api-reference/docs-v5/interfaces/linkcadocsparams.md)*, void›*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*linkDocuments*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#linkdocuments)

*Defined in* [*src/api/entities/CorporateAction/index.ts:148*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L148)

Link a list of documents to this corporate action

**`param`** list of documents

**`note`** any previous links are removed in favor of the new list

**`note`** required role:

* Corporate Actions Agent

### maxAmount

• **maxAmount**: *BigNumber*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:81*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L81)

maximum amount of `currency` to be distributed. Distributions are "first come, first served", so funds can be depleted before every Tokenholder receives their corresponding amount

### modifyCheckpoint

• **modifyCheckpoint**: *ProcedureMethod‹ModifyDistributionCheckpointParams, void›*

*Overrides* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*modifyCheckpoint*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#modifycheckpoint)

*Defined in* [*src/api/entities/DividendDistribution/index.ts:159*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L159)

Modify the Distribution's checkpoint

### origin

• **origin**: [*DefaultPortfolio*](/polymesh-sdk-api-reference/docs-v5/classes/defaultportfolio.md) *|* [*NumberedPortfolio*](/polymesh-sdk-api-reference/docs-v5/classes/numberedportfolio.md)

*Defined in* [*src/api/entities/DividendDistribution/index.ts:65*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L65)

Portfolio from which the dividends will be distributed

### pay

• **pay**: *ProcedureMethod‹*[*PayDividendsParams*](/polymesh-sdk-api-reference/docs-v5/interfaces/paydividendsparams.md)*, void›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:164*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L164)

Transfer the corresponding share of the dividends to a list of Identities

### paymentDate

• **paymentDate**: *Date*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:91*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L91)

date starting from which dividends can be paid/reclaimed

### perShare

• **perShare**: *BigNumber*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:75*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L75)

amount of `currency` to pay for each share the Tokenholder holds

### reclaimFunds

• **reclaimFunds**: *ProcedureMethod‹void, void›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:174*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L174)

Reclaim any remaining funds back to the origin Portfolio. This can only be done after the Distribution has expired

**`note`** withheld taxes are also reclaimed in the same transaction

**`note`** required roles:

* Origin Portfolio Custodian

### targets

• **targets**: [*CorporateActionTargets*](/polymesh-sdk-api-reference/docs-v5/interfaces/corporateactiontargets.md)

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*targets*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#targets)

*Defined in* [*src/api/entities/CorporateAction/index.ts:81*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L81)

tokenholder identities related to this Corporate action. If the treatment is `Exclude`, the identities are not targeted by the Action, and any identities left out of the array will be targeted, and vice versa

### taxWithholdings

• **taxWithholdings**: [*TaxWithholding*](/polymesh-sdk-api-reference/docs-v5/interfaces/taxwithholding.md)*\[]*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*taxWithholdings*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#taxwithholdings)

*Defined in* [*src/api/entities/CorporateAction/index.ts:92*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L92)

percentage of tax withholding per Identity. Any Identity not present in this array uses the default tax withholding percentage

### ticker

• **ticker**: *string*

*Inherited from* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*ticker*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#ticker)

*Defined in* [*src/api/entities/CorporateAction/index.ts:65*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/CorporateAction/index.ts#L65)

ticker of the Security Token

### uuid

• **uuid**: *string*

*Inherited from* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*.*[*uuid*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md#uuid)

*Defined in* [*src/api/entities/Entity.ts:46*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/Entity.ts#L46)

## Methods

### checkpoint

▸ **checkpoint**(): *Promise‹*[*Checkpoint*](/polymesh-sdk-api-reference/docs-v5/classes/checkpoint.md) *|* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*›*

*Overrides* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*checkpoint*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#checkpoint)

*Defined in* [*src/api/entities/DividendDistribution/index.ts:180*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L180)

Retrieve the Checkpoint associated with this Dividend Distribution. If the Checkpoint is scheduled and has not been created yet, the corresponding CheckpointSchedule is returned instead

**Returns:** *Promise‹*[*Checkpoint*](/polymesh-sdk-api-reference/docs-v5/classes/checkpoint.md) *|* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*›*

### details

▸ **details**(): *Promise‹*[*DividendDistributionDetails*](/polymesh-sdk-api-reference/docs-v5/interfaces/dividenddistributiondetails.md)*›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:199*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L199)

Retrieve details associated with this Dividend Distribution

**Returns:** *Promise‹*[*DividendDistributionDetails*](/polymesh-sdk-api-reference/docs-v5/interfaces/dividenddistributiondetails.md)*›*

### exists

▸ **exists**(): *Promise‹boolean›*

*Overrides* [*CorporateAction*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md)*.*[*exists*](/polymesh-sdk-api-reference/docs-v5/classes/corporateaction.md#exists)

*Defined in* [*src/api/entities/DividendDistribution/index.ts:190*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L190)

Retrieve whether the Distribution exists

**Returns:** *Promise‹boolean›*

### getParticipants

▸ **getParticipants**(): *Promise‹*[*DistributionParticipant*](/polymesh-sdk-api-reference/docs-v5/interfaces/distributionparticipant.md)*\[]›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:225*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L225)

Retrieve a comprehensive list of all Identities that are entitled to dividends in this Distribution (participants), the amount they are entitled to and whether they have been paid or not

**`note`** this request can take a lot of time with large amounts of Tokenholders

**`note`** if the Distribution Checkpoint hasn't been created yet, the result will be an empty array. This is because the Distribution participants cannot be determined without a Checkpoint

**Returns:** *Promise‹*[*DistributionParticipant*](/polymesh-sdk-api-reference/docs-v5/interfaces/distributionparticipant.md)*\[]›*

### getWithheldTax

▸ **getWithheldTax**(): *Promise‹BigNumber›*

*Defined in* [*src/api/entities/DividendDistribution/index.ts:292*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/DividendDistribution/index.ts#L292)

Retrieve the amount of taxes that have been withheld up to this point in this Distribution

**`note`** uses the middleware

**Returns:** *Promise‹BigNumber›*

### isEqual

▸ **isEqual**(`entity`: [Entity](/polymesh-sdk-api-reference/docs-v5/classes/entity.md)‹object›): *boolean*

*Inherited from* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*.*[*isEqual*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md#isequal)

*Defined in* [*src/api/entities/Entity.ts:61*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/Entity.ts#L61)

Whether this Entity is the same as another one

**Parameters:**

| Name     | Type                                                                    |
| -------- | ----------------------------------------------------------------------- |
| `entity` | [Entity](/polymesh-sdk-api-reference/docs-v5/classes/entity.md)‹object› |

**Returns:** *boolean*

### `Static` generateUuid

▸ **generateUuid**‹**Identifiers**›(`identifiers`: Identifiers): *string*

*Inherited from* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*.*[*generateUuid*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md#static-generateuuid)

*Defined in* [*src/api/entities/Entity.ts:14*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/Entity.ts#L14)

Generate the Entity's UUID from its identifying properties

**Type parameters:**

▪ **Identifiers**: *object*

**Parameters:**

| Name          | Type        | Description |
| ------------- | ----------- | ----------- |
| `identifiers` | Identifiers |             |

**Returns:** *string*

### `Static` unserialize

▸ **unserialize**‹**Identifiers**›(`serialized`: string): *Identifiers*

*Inherited from* [*CheckpointSchedule*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md)*.*[*unserialize*](/polymesh-sdk-api-reference/docs-v5/classes/checkpointschedule.md#static-unserialize)

*Defined in* [*src/api/entities/Entity.ts:23*](https://github.com/PolymathNetwork/polymesh-sdk/blob/524b0225/src/api/entities/Entity.ts#L23)

Unserialize a UUID into its Unique Identifiers

**Type parameters:**

▪ **Identifiers**: *object*

**Parameters:**

| Name         | Type   | Description         |
| ------------ | ------ | ------------------- |
| `serialized` | string | UUID to unserialize |

**Returns:** *Identifiers*