---
title: "Understanding dedicated corporate action events"
slug: "understanding-dedicated-corporate-action-events"
updated: 2026-10-13T10:27:38Z
published: 2026-10-13T10:27:38Z
canonical: "support.lusid.com/understanding-dedicated-corporate-action-events"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding dedicated corporate action events

LUSID is transitioning to a system where each corporate action for an instrument of type `Equity` has a dedicated event, enabling you to handle those events in a seamless and consistent manner.

> [!WARNING]
> **Important**: To enable instrument events, register a recipe with every portfolio you wish events to impact. [More information](/v1/docs/setting-a-portfolio-recipe).

For example, LUSID emits a `CashDividendEvent` on the ex-date providing you [manually load a cash dividend corporate action](/v1/docs/how-do-i-upload-corporate-actions-to-a-corporate-action-source) in time into a corporate action source registered with the portfolio. In addition:

- **LUSID provides** a `CashDividendEvent` [default transaction template](/v1/docs/what-is-a-transaction-template) that automatically generates a transaction representing the cash dividend amount. You can override this default template if you wish, but it is not necessary.
- **You must implement** a `DividendIncome` [transaction type](/v1/docs/what-is-a-transaction-type) to confer a suitable economic impact on this automatically-generated transaction. We provide a recommendation, which you can either implement as-is or change if desired.

> **Note**: Term instruments such as bonds, swaps, options and futures that mature and therefore have an intrinsic lifecycle automatically trigger LUSID to emit events. [More information](/v1/docs/understanding-instrument-lifecycle-events-emitted-by-lusid).

With this transaction type in place, and for each portfolio subscribed to the corporate action source *and* with a holding on the ex-date, LUSID automatically:

- Generates an [output transaction](/v1/docs/input-and-output-transactions) scaled to your holding in that portfolio, and enriched with extra information such as gain/loss or a tax calculation.
- Implements the economic impact prescribed by the transaction type, for example adding the dividend amount to a particular cash balance.

Note you can override or configure a specific event for a particular portfolio by loading an [event instruction](/v1/docs/loading-an-event-instruction-to-override-an-instrument-event-for-a-particular-portfolio).

**Recommended reading**: [Handling a cash dividend corporate action event](/v1/docs/handling-a-cash-dividend-corporate-action-event)

The following dedicated events are available for instruments of type `Equity` and `SimpleInstrument`. If a particular event is not available yet, you can [continue modelling](/v1/docs/modelling-unsupported-corporate-actions-as-transition-events) any kind of corporate action as a `TransitionEvent`.

> **Note**: If an event should generate an output transaction but doesn’t, the issue usually relates to transaction type scopes and sources. [Troubleshooting guide](/v1/docs/how-does-lusid-resolve-transaction-templates-and-types-for-instrument-lifecycle-events).

| **Corporate action** | **Dedicated LUSID event** | [**Participations**](/v1/docs/understanding-participation-types-and-elections-for-corporate-actions) | **Elections** | **Transaction type recommendation(s) requiring implementation** |
| --- | --- | --- | --- | --- |
| [Accumulation (ACCU)](/v1/docs/modelling-an-accumulation-dividend-accu) | `AccumulationEvent` | Mandatory with choices | N/A | [FundAccumulationIncome](/v1/docs/recommended-transaction-types-for-corporate-action-events#accumulationevent) |
| Bankruptcy (BRUP) | `BankruptcyEvent` | Mandatory, Voluntary | Cash, Lapse | `BankruptcyCashRecovery` |
| [Bonus issue (BONU)](/v1/docs/modelling-a-bonus-issue-bonu) | `BonusIssueEvent` | Mandatory, Mandatory with choices | Security, Mixed lot constituents, Cash, Lapse | - [BonusIssueAdditionalUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#bonusissueevent) - [BonusIssueCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#bonusissuecashinlieu-transaction-type) - [BonusIssueCashOffer](/v1/docs/recommended-transaction-types-for-corporate-action-events#bonusissuecashoffer-transaction-type) - [BonusIssueBuyUp](/v1/docs/recommended-transaction-types-for-corporate-action-events#bonusissuebuyup-transaction-type) |
| [Call on intermediate securities (EXRI)](/v1/docs/modelling-a-call-on-intermediate-securities-exri) | `CallOnIntermediateSecuritiesEvent` | Mandatory with choices | Option exercise, Lapse | - [ExerciseIntermediateSecurities](/v1/docs/recommended-transaction-types-for-corporate-action-events#callonintermediatesecuritiesevent) - [ExpireIntermediateSecurities](/v1/docs/recommended-transaction-types-for-corporate-action-events#expireintermediatesecurities-transaction-type) |
| [Capital distribution (CAPD)](/v1/docs/modelling-a-capital-distribution-capd) | `CapitalDistributionEvent` | Mandatory, Mandatory with choices | Cash (choice of currencies) | [DistributionIncome](/v1/docs/recommended-transaction-types-for-corporate-action-events#capitaldistributionevent) |
| [Capital gain distribution (CAPG)](/v1/docs/modelling-a-capital-gain-distribution-capg) | `CapitalGainsDistributionEvent` | Mandatory, Mandatory with choices | Cash (choice of currencies) | [CashReceipt](/v1/docs/recommended-transaction-types-for-corporate-action-events#capitalgainsdistributionevent) |
| [Cash dividend (DVCA)](/v1/docs/modelling-a-cash-dividend-dvca) | `CashDividendEvent` | Mandatory, Mandatory with choices | Cash (choice of currencies) | [DividendIncome](/v1/docs/recommended-transaction-types-for-corporate-action-events#cashdividendevent) |
| Change (CHAN) | `ChangeEvent` | Mandatory | N/A | - `ChangeAssimilationDebit` - `ChangeAssimilationCredit` |
| [Class action (CLSA)](/v1/docs/modelling-a-class-action-clsa) | `ClassActionEvent` | Voluntary | Cash, Lapse | `ClassActionSettle` |
| Consent (CONS) | `ConsentEvent` | Mandatory, Voluntary | Cash, Consent granted, Lapse | `ConsentAccept` |
| Conversion (CONV) | `ConversionEvent` | Mandatory, Voluntary | Security, Cash & security, Mixed lot constituents, Cash, Lapse | - [ConvRemoveExisting](/v1/docs/recommended-transaction-types-for-corporate-action-events#conversionevent) - [ConvAdjustCost](/v1/docs/recommended-transaction-types-for-corporate-action-events#convadjustcost-transaction-type) - [ConvReceiveCash](/v1/docs/recommended-transaction-types-for-corporate-action-events#convreceivecash-transaction-type) - [ConvReceiveUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#convreceiveunits-transaction-type) - [ConvCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#convcashinlieu-transaction-type) - `ConvBuyUp` - `ConvMixedLotCashPayout` - `Rule144AExchangeAdjustCost` - `Rule144AExchangeReceiveUnits` |
| Delisting (DLST) | `DelistingEvent` | Mandatory | N/A | N/A |
| [Dividend option (DVOP)](/v1/docs/modelling-a-dividend-option-dvop) | `DividendOptionEvent` | Mandatory with choices | Security, Cash | - [DvopCashIncome](/v1/docs/recommended-transaction-types-for-corporate-action-events#dividendoptionevent) - [DvopSecurityOption](/v1/docs/recommended-transaction-types-for-corporate-action-events#dvopsecurityoption-transaction-type) |
| [Dividend reinvestment (DRIP)](/v1/docs/modelling-a-dividend-reinvestment-drip) | `DividendReinvestmentEvent` | Mandatory with choices | Security, Cash | - [DripCashIncome](/v1/docs/recommended-transaction-types-for-corporate-action-events#dividendreinvestmentevent) - [DripSecurityReinvestment](/v1/docs/recommended-transaction-types-for-corporate-action-events#dripsecurityreinvestment-transaction-type) |
| Dutch auction (DTCH) | `DutchAuctionEvent` | Voluntary | Tender, Security, Cash & security, Mixed lot constituents, Lapse | - `DutchAuctionAccept` - `DutchAuctionRemoveExisting` - `DutchAuctionReceiveUnits` - `DutchAuctionCashSettlement` - `DutchAuctionCashInLieu` |
| Exchange offer (EXOF) | `ExchangeOfferEvent` | Mandatory, Mandatory with choices, Voluntary | Security, Cash & security, Mixed lot constituents, Consent & exchange, Cash, Lapse | - `ExchangeRemoveExisting` - `ExchangeReceiveUnits` - `ExchangeCashInLieu` - `ExchangeOfferBuyUp` - `ExchangeReceiveCash` |
| [Intermediate securities distribution event (RHDI)](/v1/docs/modelling-an-intermediate-securities-distribution-rhdi) | `IntermediateSecuritiesDistributionEvent` | Mandatory | N/A | - [IntermediateSecurityUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#intermediatesecuritiesdistributionevent) - [IntermediateSecurityCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#intermediatesecuritycashinlieu-transaction-type) - `IntermediateSecurityBuyUp` |
| Liquidation payment (LIQU) (`Equity` only) | `LiquidationPaymentEvent` | Mandatory | Cash | - `LiquidationCash` - `LiquidationCashFinal` |
| Merger (MRGR) | `MergerEvent` | Mandatory, Mandatory with choices, Voluntary | Security, Cash & security, Mixed lot constituents, Cash | - [MergerRemoveExisting](/v1/docs/recommended-transaction-types-for-corporate-action-events#mergerevent) - [MergerAdjustCost](/v1/docs/recommended-transaction-types-for-corporate-action-events#mergeradjustcost-transaction-type) - [MergerReceiveCash](/v1/docs/recommended-transaction-types-for-corporate-action-events#mergerreceivecash-transaction-type) - [MergerReceiveUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#mergerreceiveunits-transaction-type) - [MergerCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#mergercashinlieu-transaction-type) - `MergerBuyUp` - `MergerMixedLotCashPayout` |
| Pari Passu (PARI) | `PariPassuEvent` | Mandatory | N/A | - `PariPassuAssimilationDebit` - `PariPassuAssimilationCredit` |
| Partial defeasance (PDEF) (`SimpleInstrument` only) | `PartialDefeasanceEvent` | Mandatory | N/A | N/A |
| Priority issue (PRIO) | `PriorityIssueEvent` | Voluntary | Security, Lapse | - `PriorityIssueSubscription` - `PriorityIssueFractionalCash` - `PriorityIssueBuyUp` |
| Repurchase Offer/Issuer Bid/Reverse Rights (BIDS) | `RepurchaseOfferEvent` | Voluntary | Cash, Tender, Consent & tender, Consent granted, Lapse | - `RepurchaseOfferEventChooseCash` - `RepurchaseOfferEventChooseTender` - `ConsentAccept` |
| Reverse stock split (SPLR) | `ReverseStockSplitEvent` | Mandatory | N/A | - [ReverseStockSplitUnitReduction](/v1/docs/recommended-transaction-types-for-corporate-action-events#reversestocksplitevent) - [ReverseStockSplitCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#reversestocksplitcashinlieu-transaction-type) - `ReverseStockSplitBuyUp` |
| Scrip dividend (DVSC) | `ScripDividendEvent` | Mandatory | N/A | - [ScripDividendAdditionalUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#scripdividendevent) - [ScripDividendCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#scripdividendcashinlieu-transaction-type) - `ScripDividendBuyUp` |
| Security write-off (WOFF/WRTH) | `SecurityWriteOffEvent` | Mandatory, Voluntary | Subscribe | `Worthless` |
| Spin-off (SOFF) | `SpinOffEvent` | Mandatory | N/A | - [SpinOffAdjustCost](/v1/docs/recommended-transaction-types-for-corporate-action-events#spinoffevent) - [SpinOffNewUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#spinoffnewunits-transaction-type) - [SpinOffCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#spinoffcashinlieu-transaction-type) - `SpinOffBuyUp` |
| Stock dividend (DVSE) | `StockDividendEvent` | Mandatory | N/A | - [StockDividendAdditionalUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#stockdividendevent) - [StockDividendCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#stockdividendcashinlieu-transaction-type) - `StockDividendBuyUp` |
| Stock split (SPLF) | `StockSplitEvent` | Mandatory | N/A | - [StockSplitAdditionalUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#stocksplitevent) - `StockSplitSubstitutionClose` - `StockSplitSubstitutionOpen` - [StockSplitCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#stocksplitcashinlieu-transaction-type) - `StockSplitBuyUp` |
| [Tender/Takeover (TEND)](/v1/docs/modelling-a-tender-offer-tend) | `TenderEvent` | Mandatory, Voluntary | Security, Cash & security, Mixed lot constituents, Consent & tender, Cash | - [TenderRemoveExisting](/v1/docs/recommended-transaction-types-for-corporate-action-events#tenderevent) - [TenderAdjustCost](/v1/docs/recommended-transaction-types-for-corporate-action-events#tenderadjustcost-transaction-type) - [TenderReceiveCash](/v1/docs/recommended-transaction-types-for-corporate-action-events#tenderreceivecash-transaction-type) - [TenderReceiveUnits](/v1/docs/recommended-transaction-types-for-corporate-action-events#tenderreceiveunits-transaction-type) - [TenderCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#tendercashinlieu-transaction-type) - [TenderBuyUp](/v1/docs/recommended-transaction-types-for-corporate-action-events#tenderbuyup-transaction-type) - `TenderMixedLotCashPayout` - `ConsentAccept` |
| Warrants exercise (EXWA) (`SimpleInstrument` only) | `WarrantsExerciseEvent` | Mandatory with choices, Voluntary | Option exercise, Lapse | - `WarrantExercise` - `WarrantSurrender` - `WarrantLapse` |
| Worthless (WRTH) | `WorthlessEvent` | Mandatory | N/A | `Worthless` |