> For the complete documentation index, see [llms.txt](https://docs.kaiko.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kaiko.com/kaiko-indices/reference-rates-capital-market/reference-data-corporate-actions.md).

# Reference data - corporate actions

## What is this endpoint for? <a href="#what-is-this-endpoint-for" id="what-is-this-endpoint-for"></a>

This endpoint offers supplementary corporate action reference data for any user subscribing to Reference Rates from the following asset classes:

* Equity

The data covers `stock` and `etf` instrument types and includes dividends, stock splits, mergers, spin-offs, and other structural events that impact equity prices and trading.

The data can be used for price adjustment validations, corporate action tracking, and anticipating upcoming events that affect equity valuation.&#x20;

## Endpoints

{% tabs %}
{% tab title="gRPC" %}

```url
gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService.CorporateActions
```

{% endtab %}
{% endtabs %}

## Request fields

<table><thead><tr><th width="151.50390625">Parameter</th><th width="108.2109375">Required</th><th width="232.02734375">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>isins</code></td><td>No</td><td>List of Isin codes</td><td><code>["US78462F1030","US0378331005"]</code></td></tr><tr><td><code>start_ex_date</code></td><td>No</td><td>Start date of <code>exDate</code> in ISO 8601 (exclusive).</td><td><code>2023-01-26T00:00:00.000Z</code></td></tr><tr><td><code>end_ex_date</code></td><td>No</td><td>End date of <code>exDate</code> in ISO 8601 (exclusive).</td><td><p><code>2023-01-26T00:00:00.000Z</code></p><p></p><p></p></td></tr></tbody></table>

## Response fields

<table><thead><tr><th width="210">Field</th><th width="537">Description</th></tr></thead><tbody><tr><td><code>eventUniqueID</code></td><td>The unique event ID </td></tr><tr><td><code>eventId</code></td><td>The event ID of the corporation</td></tr><tr><td><code>actionType</code></td><td>The type of the action. The output can be <a href="/pages/gbXAcMbpbMTh3tdlQBBW#cash-dividend"><code>CASH_DIVIDEND</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#stock-dividend"><code>STOCK_DIVIDEND</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#bonus"><code>BONUS</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#stock-split"><code>STOCK_SPLIT</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#reverse-split"><code>REVERSE_SPLIT</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#merger"><code>MERGER</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#takeover"><code>TAKEOVER</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#spinoff"><code>SPINOFF</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#capital-reduction"><code>CAPITAL_REDUCTION</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#rights-issues"><code>RIGHTS_ISSUE</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#entitlement"><code>ENTITLEMENT</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#distribution"><code>DISTRIBUTION</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#return-of-capital"><code>RETURN_OF_CAPITAL</code></a><code>,</code> <a href="/pages/gbXAcMbpbMTh3tdlQBBW#delisting"><code>DELISTING</code></a><code>.</code></td></tr><tr><td><code>ediEventCode</code></td><td>The event identifier.</td></tr><tr><td><code>status</code></td><td>The status of the action. The response can be <code>UPCOMING, ACTIVE, COMPLETED, HISTORICAL, UNKNOWN.</code></td></tr><tr><td><code>eventCreatedAt</code></td><td>The UTC datetime that the event is created</td></tr><tr><td><code>lastUpdatedAt</code></td><td>The UTC datetime that the event is updated</td></tr><tr><td><code>caDetails</code></td><td>The details of the action</td></tr><tr><td>   <mark style="color:$tint;"><code>.actionType</code></mark></td><td>The type of the action</td></tr><tr><td>   <mark style="color:$tint;"><code>.exDate</code></mark></td><td>The UTC datetime of the first trading day when the equity is trading without the right in question.</td></tr><tr><td>   <mark style="color:$tint;"><code>.recordDate</code></mark></td><td>The UTC datetime when the records are checked to identify the eligible recipients of a specific corporate action.</td></tr><tr><td>   <mark style="color:$tint;"><code>.paymentDate</code></mark></td><td>The UTC datetime when the action is executed.</td></tr><tr><td>   <mark style="color:$tint;"><code>.dividendType</code></mark></td><td>The type of dividend. The response can be <code>REGULAR, SPECIAL, INTERIM, FINAL</code></td></tr><tr><td><code>idDetails</code></td><td>The details of the underlying security</td></tr><tr><td>   <mark style="color:$tint;"><code>.isin</code></mark></td><td>The International Securities Identification Number (ISIN) code</td></tr><tr><td>   <mark style="color:$tint;"><code>.ticker</code></mark></td><td>The asset identifier in the local exchanges</td></tr><tr><td>   <mark style="color:$tint;"><code>.issuerName</code></mark></td><td>The name of the issuer</td></tr><tr><td>   <mark style="color:$tint;"><code>.exchangeMic</code></mark></td><td>The Market Identifier Code (MIC) where the asset is traded on</td></tr><tr><td>   <mark style="color:$tint;"><code>.bbgCompId</code></mark></td><td>The issuer ID on Bloomberg</td></tr><tr><td>   <mark style="color:$tint;"><code>.bbgCompTicker</code></mark></td><td>The issuer Ticker on Bloomberg</td></tr><tr><td>   <mark style="color:$tint;"><code>.figi</code></mark></td><td>The Financial Instrument Global Identifier (FIGI) code</td></tr><tr><td>   <mark style="color:$tint;"><code>.figiTicker</code></mark></td><td>The Financial Instrument Global Identifier (FIGI) ticker</td></tr><tr><td>   <mark style="color:$tint;"><code>.timezone</code></mark></td><td>The IANA timezone of the main trading venue</td></tr></tbody></table>

## Request examples

{% tabs %}
{% tab title="cURL" %}
**cURL requests are intended for testing purposes only.**

{% code overflow="wrap" %}

```url
grpcurl \
  -H "Authorization: Bearer $KAIKO_API_KEY" \
  -d '{
    "start_ex_date": "2026-02-01T00:00:00.000Z",
    "end_ex_date":   "2026-02-28T00:00:00.000Z"
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService.CorporateActions
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Response Example

```json
{
  "corporateActions": [
    {
      "eventUniqueId": "201010274603172",
      "eventId": "4603172",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2026-02-07T05:00:00Z",
      "lastUpdatedAt": "2026-02-07T14:11:01Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-20T05:00:00Z",
        "recordDate": "2026-02-20T05:00:00Z",
        "paymentDate": "2026-03-19T04:00:00Z",
        "currency": "USD",
        "grossDividend": 0.68,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "US75513E1010",
        "ticker": "RTX",
        "issuerName": "RTX Corp",
        "exchangeMic": "XNYS",
        "bbgCompId": "BBG000BW8S60",
        "bbgCompTicker": "RTX US",
        "figi": "BBG000BW8TX8",
        "figiTicker": "RTX UN",
        "timezone": "America/New_York"
      }
    },
    {
      "eventUniqueId": "201010274577840",
      "eventId": "4577840",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2026-01-27T15:00:00Z",
      "lastUpdatedAt": "2026-01-28T08:33:22Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-25T15:00:00Z",
        "recordDate": "2026-02-27T15:00:00Z",
        "currency": "KRW",
        "grossDividend": 1875,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "KR7000660001",
        "ticker": "000660",
        "issuerName": "SK Hynix Inc",
        "exchangeMic": "XKRX",
        "bbgCompId": "BBG000GQVT51",
        "bbgCompTicker": "000660 KS",
        "figi": "BBG000GQVTN1",
        "figiTicker": "000660 KP",
        "timezone": "Asia/Seoul"
      }
    },
    ...
  ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kaiko.com/kaiko-indices/reference-rates-capital-market/reference-data-corporate-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.