---
title: "List Corporate Actions (Instrument-level)"
method: GET
path: "/corporate_actions"
tags: ["Corporate Actions"]
---

# List Corporate Actions (Instrument-level)

`GET /corporate_actions`

## Query parameters

- `instrument` string[]
- `status` CorporateActionStatus[]
- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseInstrumentLevelCorporateActionResponseUnion
  - `data` InstrumentLevelCorporateActionResponseUnion[], required — The elements of the response. Each element is a corporate action, discriminated by the `type` property.
    - union — An object representing a corporate action at the instrument level. Unlike the per-account corporate action, this response does not include customer-specific fields such as taxes or settlement amounts.
      - InstrumentLevelCashDividendResponse — A cash dividend corporate action at the instrument level. Represents a dividend announcement for a given instrument, including key dates and the declared amount per share.
        - `id` string, required — The identifier referring to this corporate action.
        - `type` 'cash_dividend', required — The string `"cash_dividend"`, identifying this type of corporate action.
        - `instrument` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This value identifies the instrument that declared the dividend.
        - `announcement_date` string, date, nullable — The date the dividend was officially announced by the issuer.
        - `ex_date` string, date, nullable — The first day the security trades without the dividend. Shares must be purchased before this date to be eligible for the dividend payment.
        - `record_date` string, date, nullable — The date lemon.markets checks who is on the shareholder register for dividend eligibility.
        - `payable_date` string, date, required — The date the dividend is actually paid out. Due to the number of parties involved, it is common for payment to arrive a few business days after this date.
        - `amount_per_share` string, required — The gross dividend amount per share, represented as a decimal string.
        - `currency` string, required — An ISO 4217 three-letter currency code representing the currency of the `amount_per_share` value.
        - `history` StatusChangeCorporateActionStatus[] — A chronological list of status changes for this corporate action.
          - `status` 'created' | 'processed', required — The status of a corporate action: <ul> <li><code>created</code>: The corporate action has been created and is pending processing. <li><code>processed</code>: The corporate action has been fully processed. </ul>
          - `timestamp` string, date-time, required — The timestamp of the event. It represents the point in time at which the corporate action status was updated.
      - InstrumentLevelIncomeDistributionResponse — An income distribution corporate action at the instrument level. Represents a distribution from a fund or ETF, including daily factors used for calculation.
        - `id` string, required — The identifier referring to this corporate action.
        - `type` 'income_distribution', required — The string `"income_distribution"`, identifying this type of corporate action.
        - `instrument` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This value identifies the instrument that made the distribution.
        - `payable_date` string, date, nullable — The date the distribution is actually paid out. Due to the number of parties involved, it is common for payment to arrive a few business days after this date.
        - `daily_factors` DailyFactorResponse[] — A list of daily factor entries used for calculating the income distribution amount per customer.
          - `date` string, date, required — The date for which this factor applies.
          - `factor` string, required — The factor value for this date, represented as a decimal string.
        - `currency` string, nullable — An ISO 4217 three-letter currency code. Represents the currency for the distribution. The only currently available currency is `"EUR"`.
        - `history` StatusChangeCorporateActionStatus[] — A chronological list of status changes for this corporate action.
          - `status` 'created' | 'processed', required — The status of a corporate action: <ul> <li><code>created</code>: The corporate action has been created and is pending processing. <li><code>processed</code>: The corporate action has been fully processed. </ul>
          - `timestamp` string, date-time, required — The timestamp of the event. It represents the point in time at which the corporate action status was updated.
  - `pagination` EncodedPaginationResponse, required — Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string — When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)