Corporate actions

The object

Field	Type	What it is
`sourceCaId`	string	Stable id for the whole lifecycle
`version`	integer	From 1; one more on every change
`assetId`	string	The CET it applies to. In events, `tokenId` names the stream as well
`caType`	string	The kind of corporate action (below). Treat an unknown value as informational
`caCategory`	enum	`MANDATORY`, `MANDATORY_WITH_OPTIONS`, `VOLUNTARY`
`isoEventCode`	string, nullable	Indicative ISO 15022 event code, for example `DVCA`, `SPLF`, `TEND`
`status`	enum	`ANNOUNCED`, `CONFIRMED`, `ELECTION_OPEN`, `ENTITLEMENTS_FIXED`, `SETTLING`, `COMPLETED`, `POSTPONED`, `CANCELLED`
`dataCompleteness`	enum	`PRELIMINARY` (some terms unknown, `null`) or `COMPLETE`
`dates`	object	Every key always present, `null` when not applicable: `announcementDate`, `exDate`, `recordDate`, `payDate` as `YYYY-MM-DD` on the New York calendar; `snapshotTime`, `effectiveTime`, `electionStart`, `responseDeadline`, `marketExpiration`, `votingCutoff`, `meetingDate` as ISO 8601 UTC
`terms`	object	Type-specific terms (below)
`options`	array	Holder options for corporate actions with options and voluntary ones; empty otherwise
`venueActions`	object	What your venue needs to do (below)
`relatedCaIds`	array	Linked corporate actions, for example a merger and its appraisal option
`supersedesCaId`, `supersededByCaId`	string, nullable	Replacement links when a corporate action is re-announced as a new one
`correctionReason`	string, nullable	On a corrected version
`cancellationReason`	string, nullable	On a cancelled version
`description`	string, nullable	A summary for a human
`documents`	array	`{ title, url }`: the holder notice and issuer materials
`settlement`	object, nullable	On a `COMPLETED` version (below)

Snapshot time. dates.snapshotTime is the CET entitlement cut-off. CETs trade around the clock, so it is a fixed instant, 8:00 pm New York time on the business day before the ex-date or record date, and can differ from the underlying’s record date. Concurrency. Several corporate actions can be active on one asset at once. Each has its own sourceCaId; treat them independently.

Types

`caType`	Category	ISO	What happens to CET holders
`CASH_DIVIDEND`	Mandatory	`DVCA`	USDC through a distribution contract
`SPECIAL_DIVIDEND`, `RETURN_OF_CAPITAL`	Mandatory	`DVCA`, `CAPD`	USDC
`STOCK_SPLIT`, `REVERSE_SPLIT`	Mandatory	`SPLF`, `SPLR`	The token’s multiplier changes at `effectiveTime`; cash in lieu of fractions in USDC
`STOCK_DIVIDEND`	Mandatory	`DVSE`	CETs minted to holders
`SPIN_OFF`	Mandatory	`SOFF`	New CETs minted, or USDC sale proceeds
`MERGER`	Mandatory or with options	`MRGR`	CETs burned, consideration delivered in CETs and/or USDC
`LIQUIDATION`	Mandatory	`LIQU`	USDC; CETs retired when the shares are cancelled
`DELISTING`	Mandatory	`DLST`	Trading restriction and wind-down; holder options by notice
`NAME_OR_IDENTIFIER_CHANGE`	Mandatory	`CHAN`	Metadata update, with a `ca.token.updated`
`DIVIDEND_OPTION`	With options	`DVOP`	Election on the Securitize event page
`TENDER_OFFER`, `EXCHANGE_OFFER`	Voluntary	`TEND`, `EXOF`	Election by transferring CETs to an option’s address
`RIGHTS_ISSUE`, `WARRANT_EXERCISE`	Voluntary	`RHTS`, `EXWA`	Per notice; rights are not represented by CETs
`APPRAISAL`	Voluntary, linked to a merger	—	Election by transfer to an appraisal address
`MEETING`	Voluntary	`MEET`, `XMET`	Voting through Securitize
`CONSENT`	Voluntary	`CONS`	Consent through Securitize
`IST_CONVERSION`	Mandatory	—	In place: same token and address, holdings become registered positions, token name updated. No trading impact

Every type is published through the same events and endpoints. Cash distributions and splits are processed automatically by Securitize; the other types are executed by Securitize operations with the same lifecycle. A type moving to automatic processing is a minor version, recorded in the changelog. New types can be added in minor versions: a caType you do not know is informational until you support it.

Terms by type

Amounts are decimal strings. For cash distributions and splits every key is always present, null when not known yet; other types carry the keys that apply.

Type	`terms`
Cash distributions	`grossAmountPerShare`, `currency` (`USD`), `paymentAsset` `{ chainId, tokenAddress, symbol }` (USDC), `withholdingApplies` (the rate depends on each holder’s tax status, so the net amount is holder-specific), `frankingOrTaxNotes`
Splits	`ratio` `{ numerator, denominator }`, `fractionHandling`, `cashInLieuPrice` (decimal string, `null` when none), and `multiplier` `{ current, new, effectiveTime }` once the on-chain multiplier change is scheduled. At `effectiveTime` raw on-chain balances and the pool invariant do not change: the displayed balance is `raw × multiplier`, and the price per displayed unit divides by the multiplier
Stock dividend, spin-off	`ratio`, `resultingTokenId`, `resultingChainId` and `resultingContractAddress` (all three `null` when there is no CET, then `saleProceeds: true`), `fractionHandling`, `cashInLieuPerShare`
Merger	`consideration[]` of `{ type: CASH or SECURITY, amountPerShare or ratio, resultingTokenId, resultingChainId, resultingContractAddress }`, `prorationApplies`, `appraisalAvailable`, `appraisalCaId`
Tender, exchange	`offerPricePerShare` or `ratio`, `currency`, `minAcceptance`, `maxAcceptance`, `prorationApplies`, `withdrawalAllowed`, `oddLotPriority`
Meeting, consent	`meetingType` (`ANNUAL`, `SPECIAL`), `proposals[]` `{ id, title, boardRecommendation }`, `votingMethod` (`SECURITIZE_NOTICE`)
Delisting	`listingExchange` (MIC), `nmsStatusAfter`, `venueOffboardingRequired`

fractionHandling: CREDIT_FRACTIONAL (fractional CETs credited), CASH_IN_LIEU (cash for fractions), ROUND_DOWN.

Options

For MANDATORY_WITH_OPTIONS and VOLUNTARY corporate actions, options lists what a holder can choose:

Field	What it is
`optionNumber`	Stable within the corporate action, from 1
`optionType`	`CASH`, `SECURITIES`, `CASH_AND_SECURITIES`, `NO_ACTION`, `APPRAISAL`, `VOTE`
`isDefault`	The option applied when a holder takes no action
`electionMethod`	`NONE`, `SECURITIZE_PAGE` (on the Securitize event page) or `TOKEN_TRANSFER` (transferring CETs is the instruction)
`deliveryAddresses[]`	For `TOKEN_TRANSFER`: `{ chainId, address }` published by Securitize for this option. A transfer to any other address is not an instruction
`requiresLpWithdrawal`	CETs must be in the holder’s wallet, not in a pool, to participate
`responseDeadline`	Securitize’s deadline, earlier than the market’s
`withdrawalMethod`	`NONE` or `INVESTOR_SUPPORT`
`outcome`	What the holder receives: cash per share, the resulting token (`resultingTokenId`, `resultingChainId`, `resultingContractAddress`) and ratio, return of unaccepted CETs

A tender offer, with one election by transfer and a default of no action:

"options": [
  {
    "optionNumber": 1, "optionType": "CASH", "isDefault": false,
    "electionMethod": "TOKEN_TRANSFER",
    "deliveryAddresses": [{ "chainId": "eip155:196", "address": "0x5ec0a3f1c9d84b27e6f0a1b2c3d4e5f6a7b8c9d0" }],
    "requiresLpWithdrawal": true, "withdrawalMethod": "INVESTOR_SUPPORT",
    "outcome": { "cashPerShare": "41.50", "returnsUnacceptedTokens": true }
  },
  { "optionNumber": 2, "optionType": "NO_ACTION", "isDefault": true, "electionMethod": "NONE" }
]

The resulting token

When a corporate action hands holders a different token, as in an exchange offer or a spin-off, the token is identified in three keys that always travel together, in terms, in a merger’s consideration[] and in an option’s outcome:

Field	What it is
`resultingTokenId`	The token’s id, as `GET /tokens/{tokenId}` keys it
`resultingChainId`	CAIP-2 chain of the token, for example `eip155:196`. The same value as `chainId` in `GET /tokens`
`resultingContractAddress`	The token’s contract on that chain. The same value as `contractAddress` in `GET /tokens`

All three are null when there is no CET yet for what holders receive. The chain and contract address are published even when the token is not linked to your account: in that case GET /tokens/{tokenId} answers 404 TOKEN_NOT_FOUND, and you read the token’s basic information, such as its name, symbol and decimals, directly from the chain. Securitize links a resulting token to your account, and you decide whether to list it, ahead of the effective date. An exchange offer with a resulting token:

"outcome": {
  "resultingTokenId": "9e1d4c7a-2b6f-4a3e-8d5c-0f1a2b3c4d5e",
  "resultingChainId": "eip155:196",
  "resultingContractAddress": "0x2b4d6f8a0c2e4a6c8e0b2d4f6a8c0e2b4d6f8a0c",
  "ratio": { "numerator": 1, "denominator": 2 }
}

Venue actions

venueActions says what your venue needs to do, so you never infer it from the type:

Field	What it is
`tradingStop`	`{ required, at, reasonCode }`: when to stop trading the token, for example at a merger’s completion. You still follow the underlying’s halts directly
`poolMode`	`NORMAL`, `REMOVALS_ONLY` (from a given time) or `CLOSE`
`lpExitDeadline`	Deadline for voluntary liquidity withdrawal before a forced one or a Securitize unwind
`displayToHolders`	Whether to surface the event in your interface, with the link in `documents`
`transferFlowRequired`	Holders need your transfer flow to an option’s delivery addresses

Settlement

On the COMPLETED version, settlement carries what was settled for the asset:

"settlement": {
  "completedAt": "2026-11-13T16:00:00.000Z",
  "distributionContracts": [{ "chainId": "eip155:196", "address": "0x9d1c7e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d" }],
  "transactions": [{ "chainId": "eip155:196", "txHash": "0x3c5e7a9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c" }],
  "totals": [{ "description": "Total distributed", "amount": "125000.5", "symbol": "USDC" }]
}

Aggregate figures only. A venue is not the issuer and receives no per-holder entitlements, elections or payments: individual payments are observed on chain, in the distribution contract’s events and the holders’ balances.

Lifecycle rules

Creation: ca.action.created, version 1. Terms may be PRELIMINARY with null fields.
Updates: ca.action.updated when terms are confirmed or dates set; changedFields lists what changed.
Corrections: ca.action.corrected when published data was wrong, with correctionReason.
Postponement: ca.action.postponed with new dates, or with the dates null and status POSTPONED until they are set again.
Cancellation: ca.action.cancelled, status CANCELLED, with cancellationReason. Terminal. A cancellation by the issuer is published the same way, linked to the original id; there are no unlinked cancellation notices.
Replacement: a new corporate action with supersedesCaId; the old one is cancelled with supersededByCaId.
Completion: ca.action.completed with settlement. Terminal.

Keep the highest version per sourceCaId and ignore events with a lower or equal one. The guide Track a corporate action walks through it.

Get started

Guides

Concepts

Help

API reference