Corporate action reference data

What is this endpoint for?

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.

Endpoints

gRPC

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

Request fields

Parameter	Required	Description	Example
isins	No	List of Isin codes	["US78462F1030","US0378331005"]
start_ex_date	No	Start date of exDate in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z
end_ex_date	No	End date of exDate in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z

Response fields

Field	Description
eventUniqueID	The unique event ID
eventId	The event ID of the corporation
actionType	The type of the action. The output can be CASH_DIVIDEND, STOCK_DIVIDEND, SPECIAL_DIVIDEND, BONUS, STOCK_SPLIT, REVERSE_SPLIT, MERGER, TAKEOVER, SPINOFF, CAPITAL_REDUCTION, RIGHTS_ISSUE, ENTITLEMENT, DISTRIBUTION, RETURN_OF_CAPITAL, DELISTING.
ediEventCode	The event identifier.
status	The status of the action. The response can be UPCOMING, ACTIVE, COMPLETED, HISTORICAL, UNKNOWN.
eventCreatedAt	The date that the event is created
lastUpdatedAt	The last date that the event is updated
caDetails	The details of the action
actionType	The type of the action
exDate	The first trading day when the equity is trading without the right in question.
recordDate	The day when the records are checked to identify the eligible recipients of a specific corporate action.
paymentDate	The day when the action is executed.
dividendType	The type of dividend. The response can be REGULAR, SPECIAL, INTERIM, FINAL
idDetails	The details of the underlying security
isin	The International Securities Identification Number (ISIN) code
ticker	The asset identifier in the local exchanges
issuerName	The name of the issuer
exchangeMic	The Market Identifier Code (MIC) where the asset is traded on
bbgCompId	The issuer ID on Bloomberg
bbgCompTicker	The issuer Ticker on Bloomberg
figi	The Financial Instrument Global Identifier (FIGI) code
figiTicker	The Financial Instrument Global Identifier (FIGI) ticker

Request examples

cURL

cURL requests are intended for testing purposes only.

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

Response Example

{
  "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"
      }
    }
  ]
}