Source: https://databento.com/docs/conventions/corporate-actions-events



# Corporate actions events

> **See also**
>
> [Corporate actions](https://databento.com/docs/datasets/corporate-actions.md) dataset guide for further details.

### Company Meeting (`AGM`)

Annual General meeting of shareholders is held once a year, usually after the end of the financial year. Also includes other meeting types such as Extraordinary General Meeting, Special General Meeting, Court Ordered Meeting, and Postal Ballot.

- Event level: **Issuer**
- Event category: **Proposals**
- Event participation: **Voluntary**
- Values for `event_subtype`:
    - `AGM`: Annual General Meeting
    - `BHM`: Bond Holder Meeting
    - `CGM`: Court Ordered General Meeting
    - `EGM`: Extraordinary General Meeting
    - `GM`: General Meeting
    - `SGM`: Special General Meeting

#### **Calendar Dates**

- `event_date` (equal to `meeting_date`)
- `effective_date` (equal to `meeting_date`)
- `record_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `meeting_number` | Company Meeting Number |
| `event_info` | `meeting_time` | Local time for Start of Meeting |
| `event_info` | `address_line1` | Address line 1 |
| `event_info` | `address_line2` | Address line 2 |
| `event_info` | `address_line3` | Address line 3 |
| `event_info` | `address_line4` | Address line 4 |
| `event_info` | `address_line5` | Address line 5 |
| `event_info` | `address_line6` | Address line 6 |
| `event_info` | `city` | City |
| `event_info` | `country` | Country Code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |

### Announcement (`ANN`)

Intent of the company to have Corporate Action which may affect the shareholder's value. The intent may or may not materialise into an event.

- Event level: **Issuer**
- Event category: **Proposals**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `notification_date`)
- `notification_date`

### Arrangement (`ARR`)

A general term referring to complex reorganisation of a company or a group of companies and its capital.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory / Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`
- `exp_completion_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |

### Assimilation (`ASSM`)

A general term referring to complex reorganisation of a company or a group of companies and its capital.

- Event level: **Listing**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `assimilation_date`)
- `effective_date` (equal to `assimilation_date`)
- `payment_date`

### Buy Back (`BB`)

Buyback events can also be used to transmit Dutch Auction events.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- Values for `event_subtype`:
    - `DUTCHAUCT`: Dutch Auction
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `end_date`)
- `effective_date` (equal to `start_date`)
- `record_date`
- `payment_date`
- `to_date`
- `registration_date`
- `start_date`
- `end_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `buy_back_min_percentage` | Minimum percentage of the shares outstanding the company will buy back from shareholders. |
| `event_info` | `buy_back_max_percentage` | Maximum percentage of the shares outstanding the company will buy back from shareholders. |
| `event_info` | `on_off_flag` | The mechanism adopted by the company for buying back the shares. Default blank. N - On Market i.e. via the exchange. F - Off Market i.e. some other mechanism other than the exchange. (See **[ONOFFMKT](https://databento.com/docs/conventions/reference-data-enums.md#onoffmkt)** enum) |

### BBG Composite Change (`BBCC`)

To allow change in Bloomberg's ticker or the mapping of BBG ID to a Security ID.

- Event level: **Country**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_bbg_comp_id` | Old Bloomberg Composite ID |
| `event_info` | `new_bbg_comp_id` | New Bloomberg Composite ID |
| `event_info` | `old_bbg_comp_ticker` | Old Bloomberg Composite Ticker |
| `event_info` | `new_bbg_comp_ticker` | New Bloomberg Composite Ticker |
| `event_info` | `old_currency` | Old Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `new_currency` | New Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `old_country` | Old Country Code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `new_country` | New Country Code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |

### BBG Figi Change (`BBEC`)

To allow change in Bloomberg's ticker or the mapping of BBG ID to a ISO 4217 exchange code.

- Event level: **Listing**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_figi` | Old Bloomberg Exchange ID - Old Figi |
| `event_info` | `new_figi` | New Bloomberg Exchange ID - New Figi |
| `event_info` | `old_figi_ticker` | Old Bloomberg Exchange Ticker - Old Figi Ticker |
| `event_info` | `new_figi_ticker` | New Bloomberg Exchange Ticker - New Figi Ticker |
| `event_info` | `old_currency` | Old Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `new_currency` | New Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `old_exchange` | Old Exchange Code - ISO 4217 (See **[EXCHANGE](https://databento.com/docs/conventions/reference-data-enums.md#exchange)** enum) |
| `event_info` | `new_exchange` | New Exchange Code - ISO 4217 (See **[EXCHANGE](https://databento.com/docs/conventions/reference-data-enums.md#exchange)** enum) |

### Bankruptcy (`BKRP`)

When a company's net worth goes below the country's stipulated guideline. There could be several stages in the Bankruptcy process. Hence, one sees several announcements over a period of time. The end result of Bankruptcy could be revival, sale, re-organisation, liquidation etc.

- Event level: **Issuer**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `filing_date`)
- `effective_date` (equal to `filing_date`)
- `notification_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `date_info` | `emergence_date` | Emergence from Bankruptcy Date currently used in US only. |

### Bonus (`BON`)

Issue of FREE securities to the shareholders of the Company by capitalising the reserves of the company. Security being issued can be an instrument other than Equity Share.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `DPRCPDIV`: Depository Receipt Dividend

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `lapsed_premium` | If the underlying security has a Bonus issue and company decides ADR shares will not have bonus. The company will sell the share on behalf of ADR holders in the market and return the money to ADR holders. So there is no ratio. |

### Bonus Rights (`BR`)

A Bonus issue with tradable rights attached. Effectively, a mixture of Bonus and Rights.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory / Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_subscription_date`
- `end_subscription_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `issue_price` | Issue Price |
| `date_info` | `starttrade_date` | Start Trade Date |
| `date_info` | `endtrade_date` | End Trade Date |
| `date_info` | `split_date` | Split Date |
| `event_info` | `sub_exp_time` | For a specified date, the time at which the event is set to expire. |
| `event_info` | `sub_exp_time_zone` | Time Zone of the Expiry Time. |
| `event_info` | `over_subscription` | A flag to indicate if the shareholders have the option of oversubscribing for the issue. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `trading_security_id` | Security ID of the security that may be created for Trading purposes. (Join with the `security_id` field) |
| `event_info` | `trading_isin` | Trading ISIN if applicable/available |

### Call (`CALL`)

Where the issue price of a security in an offer is split in such a way that the shareholders have to pay the issue price in installments. Until the full issue price is received by the company the security remains as Partly Paid. A call is a demand to pay an installment.

- Event level: **Security**
- Event category: **Distribution Debit**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `due_date`)
- `effective_date` (equal to `due_date`)
- `record_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `to_face_value` | To Face Value |
| `rate_info` | `to_premium` | To Premium |
| `event_info` | `call_number` | Number of the call which the company has made on the security. For example: 1st Call, 2nd Call, 3rd Call |

### Capital Reduction (`CAPRD`)

Write off of existing Equity Capital of a company by either reducing the par value and/or by cancelling a certain number of shares or capital. If a cash payment is involved then it is described as Return of Capital.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`
- `record_date`
- `payment_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |

### Class Action (`CLSAC`)

Holders of security(ies) of a company combine to file a suit for damages from the company.

- Event level: **Security**
- Event category: **Legal Action**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date`
- `effective_date`
- `start_date`
- `end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `settlement_amount` | Settlement Amount |
| `date_info` | `filing_date` | Filing Date |
| `date_info` | `lead_plaintiff_deadline_date` | Lead Plaintiff Deadline Date |
| `date_info` | `proof_filing_deadline_date` | Proof Filing Deadline Date |
| `date_info` | `claim_filing_deadline_date` | Claims Filing Deadline Date |
| `date_info` | `objection_deadline_date` | Objection Deadline Date |
| `date_info` | `exclusion_deadline_date` | Exclusion Deadline Date |
| `event_info` | `court_id` | Unique ID of the Court with which the complaint has been filed |
| `event_info` | `case_number` | Court assigned number of the case |
| `event_info` | `judge` | Judge's name |
| `event_info` | `case_name` | Name of the Case |
| `event_info` | `allegations` | Reasons for which the claimants are initiating a class action. For example: Fraud, Misrepresentation, non-disclosure, insider trading etc. (See **[ALLEGATION](https://databento.com/docs/conventions/reference-data-enums.md#allegation)** enum) |
| `event_info` | `eligible_securities` | Securities eligible to participate in the action |
| `event_info` | `investor_class` | Investor class that can participate in the action (See **[INVESTCLS](https://databento.com/docs/conventions/reference-data-enums.md#investcls)** enum) |
| `event_info` | `on_behalf_of` | The Class Action is on behalf of buyer or seller (See **[ONBEHALF](https://databento.com/docs/conventions/reference-data-enums.md#onbehalf)** enum) |
| `event_info` | `lead_plaintiff` | Name of the Lead Plaintiff |
| `event_info` | `case_status` | Current Status of the case (See **[ONBEHALF](https://databento.com/docs/conventions/reference-data-enums.md#onbehalf)** enum) |

### Consolidation (`CONSD`)

Increase in the Face/Nominal Value of the security. Company's Equity Capital remains the same but the shares in issue reduces. Opposite of Sub-Division.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `CONSD`: Reverse Split, currently only used in US events

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |

### Conversion (`CONV`)

Details of individual Conversions of a convertible security (For example: Preference Share, Convertible Bond). Also sometimes used to transmit Voluntary Offers.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory / Voluntary**
- Values for `event_subtype`:
    - `BB`: Buyback
    - `CALL`: Call Option Exercised
    - `CLAIMSET`: Claim Settled
    - `DEFPY`: Default Payment
    - `DR`: Drawings
    - `DRL`: Drawings by lottery
    - `ECONV`: Early Conversion
    - `MAT`: Maturity
    - `ORD`: Ordinary
    - `PUT`: Put Option Exercised
    - `REDEMCLAIM`: Redemption Claim
    - `WRTDN`: Write Down
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `from_date`)
- `event_date` (equal to `to_date`)
- `effective_date`
- `record_date`
- `from_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `price` | Price |
| `rate_info` | `price_as_percent` | Price as Percent |
| `date_info` | `settlement_date` | Settlement Date |
| `event_info` | `part_final` | Indicates if the conversion is Part or Final. Part conversions may be mandatory. (See **[PARTFINAL](https://databento.com/docs/conventions/reference-data-enums.md#partfinal)** enum) |
| `event_info` | `amount_converted` | Total value of the Bonds that were converted. |
| `event_info` | `cur_pair` | Identifies the different currencies involved for the FX rate to be applied - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `fxrate` | Foreign Exchange Rate |

### Certificate Exchange (`CTX`)

Physical exchange of existing certificates for another set of certificates. This may be done in case of sub-division, lot change, name change, exchange of one type of security for another type of security.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `end_date`)
- `start_date`
- `end_date`

### Currency Redenomination (`CURRD`)

Change in Security's Capital Currency For example: French Franc to Euro. This may also result in a Par Value change.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |
| `event_info` | `old_currency` | Old Par Value Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `new_currency` | New Par Value Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |

### Distribution (`DIST`)

Issue of **free** shares of Company B to the shareholders of Company A. There is no transfer of operations/assets of Company A to Company B. The shareholder continues to hold shares in both Company A and Company B. Hence, the event is distinct from Demerger or Bonus.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `DIST`: Spin-Off, currently only used in US events

#### **Calendar Dates**

- `event_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |

### Dividend (`DIV`)

Distribution of a company's profits for a given period to the shareholders in Cash and/or Stock.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `CAPDIST`: Capital Distribution
    - `CAPGAIN`: Capital Gain
    - `DIV`: Forward Split, currently only used in US events
    - `INTDIV`: Derived from Interest Payment
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `gross_dividend` | Gross Dividend |
| `rate_info` | `net_dividend` | Net Dividend |
| `date_info` | `declaration_date` | Date Dividend announced by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `date_info` | `foreign_ex_date` | The Date on which the USD Rate to Currency value was taken. |
| `date_info` | `ex_date2` | This is the Ex Date value for Stock component of a Dividend with a Paytype of (B)oth Stock and Cash. The main Ex Date field will be for the cash payment portion of the same record. |
| `date_info` | `pay_date2` | This is the Payment Date value for Stock component of a Dividend with a Paytype of (B)oth Stock and Cash. The main Payment Date field will be for the cash payment portion of the same record. |
| `event_info` | `marker` | Dividend Marker (See **[MARKER](https://databento.com/docs/conventions/reference-data-enums.md#marker)** enum) |
| `event_info` | `frequency` | Dividend Frequency (See **[FREQ](https://databento.com/docs/conventions/reference-data-enums.md#freq)** enum) |
| `event_info` | `tbaflag` | The company intends to pay a dividend but the details are yet to be announced. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `nil_dividend` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_rescind` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `declared_currency` | Declared Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `declared_gross_amount` | Declared Gross Amount |
| `event_info` | `unused` | Unused |
| `event_info` | `approx_flag` | If dividend is temporarily an approximate value. Expect an update. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `tax_rate` | Domestic Withholding Tax Rate |
| `event_info` | `coupon` | In countries where coupons are to be submitted to obtain a benefit this field is useful. |
| `event_info` | `coupon_id` | Coupon ID |
| `event_info` | `div_rate` | Rate of Dividends as a percentage of Par Value. |
| `event_info` | `cur_pair` | Identifies the different currencies involved for the FX rate to be applied - ISO 4217 |
| `event_info` | `dep_fees` | Depositary Fees - Applies only to DR dividends |
| `event_info` | `dep_fees_currency` | Depositary Fees Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `recind_cash_div` | Cash Dividend Cancelled. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `recind_stock_div` | Stock Dividend Cancelled. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `usd_rate_to_currency` | USD Exchange Rate for Dividend Currency |
| `event_info` | `div_postponed` | Indicating Postponement of Dividend Payment (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Dividend Investment Fund (`DIVIF`)

Distribution of a company's profits for a given period to the shareholders in Cash and/or Stock, Interest from interest bearing securities and cash and, where applicable, rental income from property funds.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `DIVACC`: Dividend Accumulation
    - `DIVINC`: Dividend Income
    - `INT`: Interest Basis Unknown
    - `INTACC`: Interest Accumulation
    - `INTINC`: Interest Income
    - `PRO`: Property Basis Unknown
    - `PROACC`: Property Accumulation
    - `PROINC`: Property Income

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `group1_gross_div` | Group 1 Gross Dividend |
| `rate_info` | `group1_net_div` | Group 1 Net Dividend |
| `date_info` | `declaration_date` | Date Dividend announced by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `event_info` | `marker` | Dividend Marker (See **[MARKER](https://databento.com/docs/conventions/reference-data-enums.md#marker)** enum) |
| `event_info` | `frequency` | Dividend Frequency (See **[FREQ](https://databento.com/docs/conventions/reference-data-enums.md#freq)** enum) |
| `event_info` | `tbaflag` | The company intends to pay a dividend but the details are yet to be announced. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `nil_dividend` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_rescind` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_postponed` | Indicating Postponement of Dividend Payment (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `tax_rate` |  |
| `event_info` | `group2_gross_div` | Gross up of Group 2 Net distribution. Group 2 is Non pari passu dividend. |
| `event_info` | `group2_net_div` |  |
| `event_info` | `equalisation` | Amount attributable to net realised income that is included in the price of units created or units cancelled by the unit trust fund during the reporting period. |
| `event_info` | `franked_percentage` | Indicates the portion of the distribution that is franked expressed as a percentage. |
| `event_info` | `franked_value` | Indicates the portion of the distribution that is franked expressed as a value. |
| `event_info` | `un_fr_non_foreign_p_c_t` | Indicates the portion of the the non-foreign distribution that is unfranked expressed as a percentage. |
| `event_info` | `un_fr_non_foreign_value` | Indicates the portion of the non-foreign distribution that is unfranked expressed as a value. |
| `event_info` | `un_fr_foreign_p_c_t` | Indicates the portion of the the foreign distribution that is unfranked expressed as a percentage. |
| `event_info` | `un_fr_foreign_value` | Indicates the portion of the foreign distribution that is unfranked expressed as a value. |

### Div Reclassification (`DIVRC`)

- Event level: **Country**
- Event category: **Tax Related**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `gross_dividend` | Gross Dividend |
| `rate_info` | `net_dividend` | Net Dividend |
| `date_info` | `declaration_date` | Date Dividend announce. by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `date_info` | `tax_yearend_date` | Tax Year End Date |
| `event_info` | `div_alloc_tax_year` | Dividend Allocable to Tax Year |
| `event_info` | `income_divs` | Income Dividends |
| `event_info` | `qual_income_divs` | Qualified Income Dividends |
| `event_info` | `short_term_cap_gains` | Short Term Capital Gains |
| `event_info` | `long_term_cap_gains` | Long Term Capital Gains |
| `event_info` | `total_cap_gains` | Total Capital Gains |
| `event_info` | `qual_short_term_cap_gains` | Qualified Short Term Capital Gains |
| `event_info` | `qual_long_term_cap_gains` | Qualified Long Term Capital Gains |
| `event_info` | `qual_total_cap_gains` | Qualified Total Capital Gains |
| `event_info` | `foreign_tax_paid` | Foreign Tax Paid |
| `event_info` | `qual_foreign_tax_paid` | Qualified Foreign Tax Paid |
| `event_info` | `section1202_gain` | Section 1202 Gain |
| `event_info` | `collectables_28_percent_gain` | Collectibles(28%) Gain |
| `event_info` | `cash_liq_dist` | Cash Liquidation Distribution |
| `event_info` | `noncash_liq_dist` | Noncash Liquidation Distribution |
| `event_info` | `exempt_interest_divs` | Exempt Interest Dividends |
| `event_info` | `percentage_of_amount` | Percentage of AMT |
| `event_info` | `return_of_capital` | For US. Portion of Dividend that is a Return of Capital distribution |
| `event_info` | `under1250_section` | For US. Portion of Dividend that is a 1250 section distribution |
| `event_info` | `section199a_inc_div` | Section 199A Income Dividend |
| `event_info` | `section199a_short_term_cap_gain` | Section 199A STCG |
| `event_info` | `section199a_foreign_tax_paid` | Section 199A Foreign Tax Paid |
| `event_info` | `nra_exempt_inc_div` | NRA Exempt Income Dividend |

### Demerger (`DMRGR`)

Separation of a portion of company A's operations/assets into Company B. Shareholders of Company A receive free shares of Company B. (AKA Spin-off)

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `DMRGR`: Spin-Off, currently only used in US events

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `effective_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`
- `exp_completion_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |

### DR Change (`DRCHG`)

Changes in the ratio or underlying security of the Depository Receipt.

- Event level: **Security**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_deposit_receipt_ratio` | Number of old DR's held in DR - UN Ratio |
| `event_info` | `new_deposit_receipt_ratio` | Number of new DR's held in DR - UN Ratio |
| `event_info` | `old_unit_ratio` | Number of old Underlying held in DR - UN Ratio |
| `event_info` | `new_unit_ratio` | Number of new Underlying held in DR - UN Ratio |
| `event_info` | `old_unit_security_id` | Internal Security ID for the Old Underlying Security (Join with the `security_id` field) |
| `event_info` | `new_unit_security_id` | Internal Security ID for the New Underlying Security (Join with the `security_id` field) |
| `event_info` | `old_depbank` | Old Depositary Bank |
| `event_info` | `new_depbank` | New Depositary Bank |
| `event_info` | `old_deposit_receipttype` | Old DR Security Type (See **[DRTYPE](https://databento.com/docs/conventions/reference-data-enums.md#drtype)** enum) |
| `event_info` | `new_deposit_receipttype` | New DR Security Type (See **[DRTYPE](https://databento.com/docs/conventions/reference-data-enums.md#drtype)** enum) |
| `event_info` | `old_level` | Old Level |
| `event_info` | `new_level` | New Level |

### Dividend Reinvestment Plan (`DRIP`)

- Event level: **Country**
- Event category: **Distribution**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `drip_reinv_price` | Reinvestment Price |
| `date_info` | `declaration_date` | Date Dividend announced by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `date_info` | `drip_last_date` | Last Date to opt for DRIP |
| `date_info` | `drip_pay_date` | DRIP Payment Date |
| `date_info` | `crest_date` | Crest Settlement Date |
| `event_info` | `marker` | Dividend Marker (See **[MARKER](https://databento.com/docs/conventions/reference-data-enums.md#marker)** enum) |
| `event_info` | `frequency` | Dividend Frequency (See **[FREQ](https://databento.com/docs/conventions/reference-data-enums.md#freq)** enum) |
| `event_info` | `tbaflag` | The company intends to pay a dividend but the details are yet to be announced. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `nil_dividend` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_rescind` | Same as a Cancelled Dividend (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `declared_currency` | Declared Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `declared_gross_amount` | Declared Gross Amount |
| `event_info` | `stamp_duty` | Stamp Duty |
| `event_info` | `stamp_as_percent` | Stamp Duty as Percent |
| `event_info` | `com_fee` | Commission Fee |
| `event_info` | `com_as_percent` | Commission Fee as Percent |
| `event_info` | `div_postponed` | Indicating Postponement of Dividend Payment (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Divestment (`DVST`)

One or more Shareholders of a company offering whole or part of its holding to the existing shareholders of company at a price.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_subscription_date`
- `end_subscription_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `trading_security_id` | Security ID of the security that may be created for trading purposes. (Join with the `security_id` field) |
| `event_info` | `trading_isin` | Trading ISIN if applicable/available |

### Entitlement (`ENT`)

Non-renounceable & non-tradable issue of shares. Is the right to purchase new shares at the specific price. The allotment of shares will usually be in the same company.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Voluntary**
- Values for `event_subtype`:
    - `NRENRTS`: Non Renounceable Rights
    - `OPOFF`: Open Offer
    - `POFF`: Priority Offer
    - `SPP`: Share Purchase Plan

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `event_date` (equal to `end_subscription_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_subscription_date`
- `end_subscription_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `ent_issue_price` | Entitlement Issue Price |
| `event_info` | `over_subscription` | A flag to indicate if the shareholders have the option of oversubscribing for the issue. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Franking (`FRANK`)

- Event level: **Country**
- Event category: **Tax Related**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `F`: Fully franked
    - `N`: Not known
    - `P`: Partially franked
    - `U`: Unfranked

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `franked_div` | Franked Dividend Amount |
| `rate_info` | `unfranked_div` | Unfranked Dividend Amount |
| `date_info` | `declaration_date` | Date Dividend announced by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `date_info` | `foreign_ex_date` | Date USD Rate to Currency value was recorded |
| `event_info` | `marker` | Dividend Marker (See **[MARKER](https://databento.com/docs/conventions/reference-data-enums.md#marker)** enum) |
| `event_info` | `frequency` | Dividend Frequency (See **[FREQ](https://databento.com/docs/conventions/reference-data-enums.md#freq)** enum) |
| `event_info` | `tbaflag` | The company intends to pay a dividend but the details are yet to be announced. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `nil_dividend` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_rescind` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `declared_currency` | Declared Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `declared_gross_amount` | Declared Gross Amount |
| `event_info` | `div_postponed` | Indicating Postponement of Dividend Payment (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `conduit_foreign_income` | Conduit Foreign Income |
| `event_info` | `franking_credit` | Corporate Tax Rate for Franking Credit |

### Forward split (`FSPLT`)

A bonus, dividend, or subdivision event. Currently only used for US securities.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `BON`: Bonus
    - `DIV`: Dividend
    - `SD`: Subdivision

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `lapsed_premium` | If the underlying security has a Bonus issue and company decides ADR shares will not have bonus. The company will sell the share on behalf of ADR holders in the market and return the money to ADR holders. So there is no ratio. |

### Financial Transaction Tax (`FTT`)

As per EU directive, list of securities in each country on which FTT would be leviable.

- Event level: **Country**
- Event category: **Tax Related**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `end_date`)
- `start_date`
- `end_date`

### Fin. Year Change (`FYCHG`)

Change in accounting year-end of the company

- Event level: **Issuer**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `notification_date`)
- `notification_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `date_info` | `old_fin_year_start_date` | Old Financial Year Start Date |
| `date_info` | `old_fin_year_end_date` | Old Financial Year End Date |
| `date_info` | `new_fin_year_start_date` | New Financial Year Start Date |
| `date_info` | `new_fin_year_end_date` | New Financial Year End Date |

### Internat. Code Change (`ICC`)

A change in any of the international codes in the system. For a security the International codes will be common across countries.

- Event level: **Security**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_i_s_i_n` | Old Isin |
| `event_info` | `new_i_s_i_n` | New Isin |
| `event_info` | `old_us_code` | Old US code |
| `event_info` | `new_us_code` | New US code |

### Incorporation Change (`INCHG`)

Change in the Country of Incorporation of the Issuer.

- Event level: **Issuer**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `incorporation_change_date`)
- `effective_date` (equal to `incorporation_change_date`)

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_country` | Old ISO Country - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `new_country` | New ISO Country - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |

### Issuer Name Change (`ISCHG`)

Change in the name of the Issuer.

- Event level: **Issuer**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `name_change_date`)
- `effective_date` (equal to `name_change_date`)

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `issuer_old_name` | Old Issuer Name |
| `event_info` | `issuer_new_name` | New Issuer Name |
| `event_info` | `legal_name` | Flagged if New Issuer Name is the legal name (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `meeting_date_flag` | Meeting Date Flag (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Local Code Change (`LCC`)

A change to the Localcode/Symbol/Ticker of the Security.

- Event level: **Listing**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_localcode` | Old Local Code |
| `event_info` | `new_localcode` | New Local Code |

### Liquidation (`LIQ`)

A process by which a bankrupt company is sold off as per the Liquidators' guidelines. The shareholders of the company may receive payment from the liquidation proceeds.

- Event level: **Issuer**
- Event category: **Distribution**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `record_date`)
- `record_date`
- `payment_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `liquidator` | Name of the agency appointed for liquidating the assets of the company. |
| `event_info` | `liq_add1` | Address Line 1 |
| `event_info` | `liq_add2` | Address Line 2 |
| `event_info` | `liq_add3` | Address Line 3 |
| `event_info` | `liq_add4` | Address Line 4 |
| `event_info` | `liq_add5` | Address Line 5 |
| `event_info` | `liq_add6` | Address Line 6 |
| `event_info` | `liq_city` | City |
| `event_info` | `liq_country` | Country code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `liq_tel` | Phone |
| `event_info` | `liq_fax` | Fax |
| `event_info` | `liq_email` | Email |

### List Status Change (`LSTAT`)

Change in the Listing Status of a security, namely Suspension, Delisting or Resumption of trading. All securities are assumed to be traded unless the listing status is changed.

- Event level: **Listing**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_lotsize` | Old Lot Size |
| `event_info` | `new_lotsize` | New Lot Size |
| `event_info` | `old_min_trading_qty` | Old Minimum Trading Quantity |
| `event_info` | `new_min_trading_qty` | New Minimum Trading Quantity |

### Mutual Fund Conv. (`MFCON`)

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_u_t_type` | Old Unit Trust Type (See **[UTTYP](https://databento.com/docs/conventions/reference-data-enums.md#uttyp)** enum) |
| `event_info` | `new_u_t_type` | New Unit Trust Type (See **[UTTYP](https://databento.com/docs/conventions/reference-data-enums.md#uttyp)** enum) |

### Market Seg Change (`MKCHG`)

Captures the movement of security from one segment to another within an Exchange.

- Event level: **Listing**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_market_segment_id` | Old Market Segment ID (See **[MKTSG](https://databento.com/docs/conventions/reference-data-enums.md#mktsg)** enum) |
| `event_info` | `new_market_segment_id` | New Market Segment ID (See **[MKTSG](https://databento.com/docs/conventions/reference-data-enums.md#mktsg)** enum) |

### Merger (`MRGR`)

Coming together of two or more companies to form a new company. Shareholders of all the old companies have to exchange their holding for shares of the new company. The original companies cease to exist.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`
- `exp_completion_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `date_info` | `appointed_date` | Appointed Date |
| `event_info` | `mrgr_status` | Progress of the Merger (See **[MRGRSTAT](https://databento.com/docs/conventions/reference-data-enums.md#mrgrstat)** enum) |

### New Listing (`NLIST`)

A new listing is when a security lists on an exchange for the first time.

- Event level: **Listing**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date`
- `effective_date`

### Odd Lot Offer (`ODDLT`)

Offer by the Issuer to the shareholder to change their odd lot holdings into round lots. It may entail sale of odd lot shares to the company or a Buy-in of balance amount by the shareholder.

- Event level: **Listing**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `end_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_date`
- `end_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `buy_in_currency` | Buy in Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `buy_in_price` | The price at which the Shareholder can opt to buy shares from the company to change his odd lot shareholding into round lot. |
| `event_info` | `buy_in_flag` | Indicates if a Buy-in is available. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Property Income Dividend (`PID`)

- Event level: **Country**
- Event category: **Tax Related**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `pid` | Property Income Dividend Portion |
| `rate_info` | `non_pid` | Non Property Income Dividend Portion |
| `date_info` | `declaration_date` | Date Dividend Announced by Issuer |
| `date_info` | `periodend_date` | Period End Date |
| `event_info` | `marker` | Dividend Marker (See **[MARKER](https://databento.com/docs/conventions/reference-data-enums.md#marker)** enum) |
| `event_info` | `frequency` | Dividend Frequency (See **[FREQ](https://databento.com/docs/conventions/reference-data-enums.md#freq)** enum) |
| `event_info` | `tbaflag` | The company intends to pay a dividend but the details are yet to be announced. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `nil_dividend` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `div_rescind` | Real Dividend event but of zero payrate. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `declared_currency` | Declared Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `declared_gross_amount` | Declared Gross Amount |
| `event_info` | `div_postponed` | Indicating Postponement of Dividend Payment. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |

### Purchase Offer (`PO`)

Company A has managerial control of Company B. Company A decides to increase its stake in Company B by offering to buy shares from the shareholders of the Company B. Company B will continue to exist.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `close_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `open_date`
- `close_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `negotiated_price` | Price at which the purchasing company struck a deal for a large chunk of the free holding, |
| `event_info` | `sealed_bid` | True if Sealed Bid (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `min_percent` | TOTAL Percentage of the shares outstanding that the purchaser will buy from the shareholders. |
| `event_info` | `max_percent` | TOTAL Percentage of the shares outstanding that the purchaser will buy from the shareholders. |

### Primary Exchange Chg (`PRCHG`)

Change in the Primary Exchange of a security.

- Event level: **Security**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_exchange` | Old Primary Exchange Code (See **[EXCHANGE](https://databento.com/docs/conventions/reference-data-enums.md#exchange)** enum) |
| `event_info` | `new_exchange` | New Primary Exchange Code (See **[EXCHANGE](https://databento.com/docs/conventions/reference-data-enums.md#exchange)** enum) |

### Preferential Offer (`PRF`)

Offer to the shareholders of Company A to buy securities of Company B on a preferential basis. This offer is a reserved portion of a public offer of Company B. Both companies are normally part of the same group.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `end_subscription_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_subscription_date`
- `end_subscription_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `event_info` | `offeree_issuer_id` | Offeree Issuer ID (Join with the `issuer_id` field) |
| `event_info` | `offeree_name` | Name of the issuer making the offer but the issuer is not available in the Corporate Actions dataset. |

### Par Value Redenomination (`PVRD`)

Write up or write down of Par Value where shares outstanding remains the same BUT the Equity Capital changes.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |

### Return of Capital (`RCAP`)

The company decides to return a portion of the equity capital in form of cash. It is often a result of Capital Reduction.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `CAPRD`: Capital Reduction
    - `LIQ`: Liquidation
    - `RES`: Reserves
    - `SOA`: Sale of Assets
    - `SPA`: Share Premium Account
    - `null`: Blank
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `payment_date`)
- `effective_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `financial_year_end_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `cash_back` | Cash Back |

### Record Date (`RD`)

Depository Receipt Record Date Event

- Event level: **Security**
- Event category: **Other**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `record_date`)
- `effective_date` (equal to `record_date`)
- `record_date`
- `to_date`

### Redemption (`REDEM`)

Details of individual redemption of a redeemable security eg. Preference Share, Bond. Also sometimes used to transmit Voluntary Offers.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory / Voluntary**
- Values for `event_subtype`:
    - `AMT`: Amortisation
    - `BBED`: Buyback Early Deadline
    - `BBRD`: Buyback Regular Deadline
    - `CORR`: Correction
    - `CU`: Clean Up
    - `ER`: Early Redemption
    - `MWC`: Make Whole Call
    - `PF`: Purchase Fund
    - `RM`: Residual Maturity
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `payment_date`)
- `event_date` (equal to `close_date`)
- `effective_date`
- `record_date`
- `payment_date`
- `to_date`
- `registration_date`
- `open_date`
- `close_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `redemption_price` | Redemption Price |
| `rate_info` | `redemption_premium` | Redemption Premium |
| `event_info` | `part_final` | Is the Redemption for this date Part or Final. Part Redemptions may be Mandatory. (See **[PARTFINAL](https://databento.com/docs/conventions/reference-data-enums.md#partfinal)** enum) |
| `event_info` | `amount_redeemed` | The total value of all the bonds redeemed i.e. in Millions. Mutually exclusive from Redemption in %. |
| `event_info` | `redemption_percentage` | Redemption in %. To allow for Redemption of security which is only on % basis. |
| `event_info` | `pool_factor` | The outstanding principal balance divided by the original principal balance with the result expressed as a Float. Useful in calculating redemption and outstanding par value. Introduced to capture this figure whenever its available. |
| `event_info` | `price_as_percentage` | Flag to indicate that the Issue Price has been quoted only in percentages. |
| `event_info` | `tender_offeror` | Name of the Offeror if it is different from the Issuer. |

### Reverse split (`RSPLT`)

A consolidation event, currently only used for US securities.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `CONSD`: Consolidation

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |

### Rights (`RTS`)

Rights Issue is an offer to existing shareholders to subscribe to further securities in proportion to their holding, at a fixed price, made by means of the issue of a renounceable letter which may be traded for a period before payment for securities is due. The allotment of shares will usually be in the same company.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Voluntary**
- Values for `event_subtype`:
    - `DPRCPDIV`: Depository Receipt Dividend
    - `null`: Generic event, no subtype provided

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `start_subscription_date`
- `end_subscription_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `issue_price` | Issue Price |
| `date_info` | `start_trade_date` | Start Trade Date |
| `date_info` | `end_trade_date` | End Trade Date |
| `date_info` | `split_date` | Split Date |
| `event_info` | `sub_exp_time` | Subscription expiry time |
| `event_info` | `sub_exp_time_zone` | Subscription expiry time zone |
| `event_info` | `over_subscription` | A flag to indicate if the shareholders have the option of oversubscribing for the issue. (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `lapsed_premium` | If the shareholder does not subscribe to the rights issue the company would pay him this sum. |
| `event_info` | `ratio_old_dist` | Distribution of Rights - Number of old shares held in old - new ratio |
| `event_info` | `ratio_new_dist` | Distribution of Rights - Number of new Rights tradable shares received in old - new ratio |
| `event_info` | `ratio_old_exer` | Exercise of Rights - Number of Rights exercised in old - new ratio |
| `event_info` | `ratio_new_exer` | Exercise of Rights - Number of resultant securities received per Rights exercised in old - new ratio |
| `event_info` | `trading_security_id` | Security ID of the security that may be created for Trading purposes. (Join with the `security_id` field) |
| `event_info` | `trading_isin` | Trading ISIN if applicable/available |
| `event_info` | `pp_security_id` | Poison Pill Rights: This rights behave same as normal rights but they do not trade at all. This rights are normally announced by the company to avoid hostile takeover. (Join with the `security_id` field) |
| `event_info` | `pp_isin` | PP ISIN if applicable/available |

### Description Change (`SCCHG`)

Change in the Security Description.

- Event level: **Security**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `security_old_name` | Previous Name |
| `event_info` | `security_new_name` | New Name |
| `event_info` | `old_security_type` | Old Security Type Code (See **[SECTYPE](https://databento.com/docs/conventions/reference-data-enums.md#sectype)** enum) |
| `event_info` | `new_security_type` | New Security Type Code (See **[SECTYPE](https://databento.com/docs/conventions/reference-data-enums.md#sectype)** enum) |
| `event_info` | `old_reg_s144a` | Old RegS144A Value (See **[REGS144A](https://databento.com/docs/conventions/reference-data-enums.md#regs144a)** enum) |
| `event_info` | `new_reg_s144a` | New RegS144A Value (See **[REGS144A](https://databento.com/docs/conventions/reference-data-enums.md#regs144a)** enum) |

### Security Swap (`SCSWP`)

An exchange of securities of Company A with those of Company B. For example: Hong Kong companies changing to Bermudan companies prior to British handover to China.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `issue_price` | Issue Price |

### Subdivision (`SD`)

Reduction in the Face/Nominal Value of the security. Company's Equity Capital remains the same but the shares in issue increases. Opposite of Consolidation.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `SD`: Forward Split, currently only used in US events

#### **Calendar Dates**

- `event_date` (equal to `ex_date`)
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `par_value_old` | Old Par Value |
| `rate_info` | `par_value_new` | New Par Value |
| `event_info` | `old_par_value_currency` | ISO Old Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `new_par_value_currency` | ISO New Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |

### Sedol Change (`SDCHG`)

Change in the SEDOL code.

- Event level: **Country**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `event_info` | `old_sedol` | Old Sedol Code |
| `event_info` | `new_sedol` | New Sedol Code |
| `event_info` | `old_country` | Old Country Code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `new_country` | New Country Code - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `old_reg_country` | Old Country of Register - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `new_reg_country` | New Country of Register - ISO 3166-1 (See **[CNTRY](https://databento.com/docs/conventions/reference-data-enums.md#cntry)** enum) |
| `event_info` | `old_trading_currency` | Old Trading Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |
| `event_info` | `new_trading_currency` | New Trading Currency Code - ISO 4217 (See **[CUREN](https://databento.com/docs/conventions/reference-data-enums.md#curen)** enum) |

### Security Reclassif. (`SECRC`)

Company reclassifying Security A as Security B or exchanging one security for another. Hence, it happens within the company. For example: Bearer Shares to Registered Shares. This event is distinct from Security Swap.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

### SOS Change (`SHOCH`)

Changes in number of Shares Outstanding of a company.

- Event level: **Security**
- Event category: **Static Reference**
- Event participation: **Mandatory**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `effective_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `date_info` | `old_outstanding_date` | Effective Date for previous SOS change |
| `date_info` | `new_outstanding_date` | Effective Date for current SOS change |
| `event_info` | `old_shares_outstanding` | Old shares outstanding amount |
| `event_info` | `new_shares_outstanding` | New shares outstanding amount |

### Spin-off (`SOFF`)

A distribution or demerger event, currently only used for US securities.

- Event level: **Security**
- Event category: **Distribution**
- Event participation: **Mandatory**
- Values for `event_subtype`:
    - `DIST`: Distribution
    - `DMRGR`: Demerger

#### **Calendar Dates**

- `event_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |

### Takeover (`TKOVR`)

Company A takes over the managerial control of Company B. Both companies may continue to exist. A Takeover may result in Compulsory Acquisition if the country's trigger limit of minimum public shareholding is breached. Compulsory Acquisition turns the Takeover event from Voluntary to Mandatory.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Mandatory / Voluntary**
- Values for `event_subtype`:
    - `MRGR`: Merger
    - `TEND`: Tender Offer
    - `TENDMRGR`: Tender resulting in Merger
    - `TKOVRMINI`: Mini-Takeover
    - `UKWNSUBTYP`: Insufficient data to assign a TKOVR event subtype

#### **Calendar Dates**

- `event_date` (equal to `effective_date`)
- `event_date` (equal to `close_date`)
- `effective_date`
- `ex_date`
- `record_date`
- `payment_date`
- `duebills_redemption_date`
- `to_date`
- `registration_date`
- `open_date`
- `close_date`
- `option_election_date`
- `withdrawal_rights_from_date`
- `withdrawal_rights_to_date`
- `exp_completion_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `min_price` | Minimum Price |
| `rate_info` | `max_price` | Maximum Price |
| `date_info` | `unconditional_date` | Unconditional Date |
| `date_info` | `compulsory_acq_date` | Compulsory Acquisition Date |
| `event_info` | `pre_offer_qty` | Number of shares held by the Offeror prior to making the Takeover offer. |
| `event_info` | `pre_offer_percentage` | Percentage of the Company's shares outstanding that the Offeror held prior to making the Takeover offer |
| `event_info` | `target_qty` | Total Quantity of shares targeted for the Takeover by the Offeror. |
| `event_info` | `target_percentage` | Percentage of the Company's shares outstanding targeted by the Offeror. |
| `event_info` | `offeror_issuer_id` | Internal `issuer_id` of the Offeror (Join with the `issuer_id` field) |
| `event_info` | `offeror_name` | Name of the issuer making the offer but the issuer is not available in the Corporate Actions dataset. |
| `event_info` | `hostile` | (T)rue if Hostile Takeover (See **[BOOLEAN](https://databento.com/docs/conventions/reference-data-enums.md#boolean)** enum) |
| `event_info` | `event_status` | Takeover Status Code (See **[TKOVRSTAT](https://databento.com/docs/conventions/reference-data-enums.md#tkovrstat)** enum) |

### Exercise of Warrants (`WAREX`)

A Warrant normally has tenure, and this tenure could result in redemption or expire: this event describes the exercise terms.

- Event level: **Security**
- Event category: **Reorganisation**
- Event participation: **Voluntary**
- **Does not use** `event_subtype`

#### **Calendar Dates**

- `event_date` (equal to `to_date`)
- `effective_date` (equal to `from_date`)
- `from_date`
- `to_date`

#### **Dynamic Fields**

| Parent [//]: # (column: sortable) | Field [//]: # (column: sortable) | Description |
| `rate_info` | `strike_price` | Strike Price |
| `rate_info` | `price_per_share` | Price Per Share |