# Corporate action reference data

## 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 equity Reference Rates from Kaiko. The data covers single stocks and ETFs, including dividends, stock splits, mergers, spin-offs, and other structural events that impact equity prices and trading. This endpoint provides real-time updates and historical corporate action events with event classifications and critical dates including ex-date, and payment date. 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 <code>CASH_DIVIDEND, STOCK_DIVIDEND, SPECIAL_DIVIDEND, BONUS, STOCK_SPLIT, REVERSE_SPLIT, MERGER, TAKEOVER, SPINOFF, CAPITAL_REDUCTION, RIGHTS_ISSUE, ENTITLEMENT, DISTRIBUTION, RETURN_OF_CAPITAL, DELISTING.</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 date that the event is created</td></tr><tr><td><code>lastUpdatedAt</code></td><td>The last date that the event is updated </td></tr><tr><td><code>caDetails</code></td><td>The details of the action</td></tr><tr><td><ul><li><mark style="color:blue;"><code>actionType</code></mark></li></ul></td><td>The type of the action</td></tr><tr><td><ul><li><mark style="color:blue;"><code>exDate</code></mark></li></ul></td><td>The first trading day when the equity is trading without the right in question.</td></tr><tr><td><ul><li><mark style="color:blue;"><code>recordDate</code></mark></li></ul></td><td>The day when the records are checked to identify the eligible recipients of a specific corporate action.</td></tr><tr><td><ul><li><mark style="color:blue;"><code>paymentDate</code></mark></li></ul></td><td>The day when the action is executed.</td></tr><tr><td><ul><li><mark style="color:blue;"><code>dividendType</code></mark></li></ul></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><ul><li><mark style="color:blue;"><code>isin</code></mark></li></ul></td><td>The International Securities Identification Number (ISIN) code</td></tr><tr><td><ul><li><mark style="color:blue;"><code>ticker</code></mark></li></ul></td><td>The asset identifier in the local exchanges</td></tr><tr><td><ul><li><mark style="color:blue;"><code>issuerName</code></mark></li></ul></td><td>The name of the issuer</td></tr><tr><td><ul><li><mark style="color:blue;"><code>exchangeMic</code></mark></li></ul></td><td>The Market Identifier Code (MIC) where the asset is traded on</td></tr><tr><td><ul><li><mark style="color:blue;"><code>bbgCompId</code></mark></li></ul></td><td>The issuer ID on Bloomberg</td></tr><tr><td><ul><li><mark style="color:blue;"><code>bbgCompTicker</code></mark></li></ul></td><td>The issuer Ticker on Bloomberg</td></tr><tr><td><ul><li><mark style="color:blue;"><code>figi</code></mark></li></ul></td><td>The Financial Instrument Global Identifier (FIGI) code</td></tr><tr><td><ul><li><mark style="color:blue;"><code>figiTicker</code></mark></li></ul></td><td>The Financial Instrument Global Identifier (FIGI) ticker</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 your_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": "201010274580606",
      "eventId": "4580606",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2026-01-30T00:00:00Z",
      "lastUpdatedAt": "2026-02-06T03:41:55Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-09T00:00:00Z",
        "recordDate": "2026-02-09T00:00:00Z",
        "paymentDate": "2026-02-12T00:00:00Z",
        "currency": "USD",
        "grossDividend": 0.26,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "US0378331005",
        "ticker": "AAPL",
        "issuerName": "Apple Inc",
        "exchangeMic": "XNAS",
        "bbgCompId": "BBG000B9XRY4",
        "bbgCompTicker": "AAPL US",
        "figi": "BBG000B9Y5X2",
        "figiTicker": "AAPL UW"
      }
    },
    {
      "eventUniqueId": "201010274430238",
      "eventId": "4430238",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2025-12-03T00:00:00Z",
      "lastUpdatedAt": "2025-12-12T13:06:50Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-19T00:00:00Z",
        "recordDate": "2026-02-19T00:00:00Z",
        "paymentDate": "2026-03-12T00:00:00Z",
        "currency": "USD",
        "grossDividend": 0.91,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "US5949181045",
        "ticker": "MSFT",
        "issuerName": "Microsoft Corporation",
        "exchangeMic": "XNAS",
        "bbgCompId": "BBG000BPH459",
        "bbgCompTicker": "MSFT US",
        "figi": "BBG000BPHFS9",
        "figiTicker": "MSFT UW"
      }
    }
  ]
}

```