---
title: "Corporate actions"
method: GET
path: "/v1/corporate-actions"
tags: ["Corporate actions"]
---

# Corporate actions

`GET /v1/corporate-actions`

## Request

- Base URL: `https://data.giftcity.in.alpaca.markets`
- URL: `https://data.giftcity.in.alpaca.markets/v1/corporate-actions`
- Auth: one of:
  - API key in header `APCA-API-KEY-ID` and API key in header `APCA-API-SECRET-KEY`
  - HTTP basic

This endpoint provides data about the corporate actions for each given symbol over a specified time period.

By default (`data_quality=complete`), corporate actions that are still incomplete (for example, missing required fields such as ex-date or CUSIP/ISIN) and have not yet been processed are excluded from the response. Pass `data_quality=all` to also receive those early, incomplete records. Already-processed corporate actions are always returned when `data_quality=complete`, even if they would otherwise be considered incomplete.

> ⚠️ Warning
>
> Currently Alpaca has no guarantees on the creation time of corporate actions. There may be delays in receiving corporate actions from our data providers, and there may be delays in processing and making them available via this API. As a result, corporate actions may not be available immediately after they are announced.

## Query parameters

- `symbols` string
- `cusips` string
- `types` string
- `region` 'us' | 'non_us' | 'all': The region to filter corporate actions by. - `us`: only US corporate actions - `non_us`: only non-US corporate actions - `all`: both US and non-US corporate actions
- `start` string, date
- `end` string, date
- `ids` string
- `limit` integer
- `data_quality` 'complete' | 'all': Controls which corporate actions are returned based on data quality. - `complete` (default): exclude corporate actions that are still missing required fields (for example, ex-date or CUSIP/ISIN) and have not yet been processed. Already-processed corporate actions are always included, even if they would otherwise be considered incomplete. - `all`: return matching corporate actions regardless of field completeness.
- `page_token` string
- `sort` 'asc' | 'desc': Sort data in ascending or descending order.

## Response `200`

OK

- CorporateActionsResp
  - `corporate_actions` CorporateActions, required
    - `capital_gains_distributions` CapitalGainsDistribution[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `long_term_rate` number, double: Long-term capital-gain payment per share.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `short_term_rate` number, double: Short-term capital-gain payment per share.
      - `symbol` string, required
    - `cash_dividends` CashDividend[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `due_bill_off_date` string, date
      - `due_bill_on_date` string, date
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `foreign` boolean, required
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `rate` number, double, required
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `special` boolean, required
      - `sub_type` 'interest' | 'return_of_capital': Sub-type of the cash dividend.
      - `symbol` string, required
    - `cash_mergers` CashMerger[]
      - `acquiree_cusip` string, required
      - `acquiree_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquiree_symbol` string, required
      - `acquirer_cusip` string
      - `acquirer_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquirer_symbol` string
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `effective_date` string, date, required: The effective date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `rate` number, double, required
    - `forward_splits` ForwardSplit[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `due_bill_redemption_date` string, date: The date when due bill obligations are redeemed.
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_rate` number, double, required
      - `old_rate` number, double, required
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `symbol` string, required
    - `name_changes` NameChange[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `new_cusip` string, required
      - `new_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_symbol` string, required
      - `old_cusip` string, required
      - `old_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `old_symbol` string, required
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
    - `partial_calls` PartialCall[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string
      - `dividend_rate` number, double
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `lottery_date` string, date
      - `lottery_type` 'original' | 'supplemental': The type of lottery for the partial call.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `price` number, double
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `results_publication_date` string, date
      - `symbol` string, required
    - `redemptions` Redemption[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `rate` number, double, required
      - `symbol` string, required
    - `reorganizations` Reorganization[]
      - `cash_rate` number, double
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `effective_date` string, date, required: The effective date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `stock_movements` ReorganizationStockMovement[]
        - `cusip` string, required
        - `isin` string
        - `new_rate` number, double, required
        - `source_rate` number, double, required
        - `symbol` string, required
      - `symbol` string, required
    - `reverse_splits` ReverseSplit[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `new_cusip` string, required
      - `new_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_rate` number, double, required
      - `new_symbol` string: The post-split ticker. Empty when the reverse split does not change the ticker (the most common case); only populated when the issuer assigns a different symbol after the split.
      - `old_cusip` string, required
      - `old_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `old_rate` number, double, required
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `symbol` string, required
    - `rights_distributions` RightsDistribution[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `expiration_date` string, date
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `new_cusip` string, required
      - `new_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_symbol` string, required
      - `payable_date` string, date, required: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `rate` number, double, required
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `source_cusip` string, required
      - `source_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `source_symbol` string, required
    - `spin_offs` SpinOff[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `due_bill_redemption_date` string, date: The date when due bill obligations are redeemed.
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `new_cusip` string, required
      - `new_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_rate` number, double, required
      - `new_symbol` string, required
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `source_cusip` string, required
      - `source_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `source_rate` number, double, required
      - `source_symbol` string, required
    - `stock_and_cash_mergers` StockAndCashMerger[]
      - `acquiree_cusip` string, required
      - `acquiree_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquiree_rate` number, double, required
      - `acquiree_symbol` string, required
      - `acquirer_cusip` string, required
      - `acquirer_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquirer_rate` number, double, required
      - `acquirer_symbol` string, required
      - `cash_rate` number, double, required
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `effective_date` string, date, required: The effective date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
    - `stock_dividends` StockDividend[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `ex_date` string, date, required: The ex-date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `rate` number, double, required
      - `record_date` string, date: The date shareholders must own shares to receive the benefit.
      - `symbol` string, required
    - `stock_mergers` StockMerger[]
      - `acquiree_cusip` string, required
      - `acquiree_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquiree_rate` number, double, required
      - `acquiree_symbol` string, required
      - `acquirer_cusip` string, required
      - `acquirer_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `acquirer_rate` number, double, required
      - `acquirer_symbol` string, required
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `effective_date` string, date, required: The effective date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
    - `unit_splits` UnitSplit[]
      - `alternate_cusip` string, required
      - `alternate_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `alternate_rate` number, double, required
      - `alternate_symbol` string, required
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `effective_date` string, date, required: The effective date marks the cutoff point for shareholders to be credited.
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `new_cusip` string, required
      - `new_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `new_rate` number, double, required
      - `new_symbol` string, required
      - `old_cusip` string, required
      - `old_isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `old_rate` number, double, required
      - `old_symbol` string, required
      - `payable_date` string, date: The date when the corporate action benefit is paid or distributed.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
    - `worthless_removals` WorthlessRemoval[]
      - `currency` string: The ISO 4217 currency code associated with the corporate action. Empty value can mean USD, non-applicable (e.g. for name changes) or unknown (can change later to a valid currency).
      - `cusip` string, required
      - `id` string, uuid, required: The internal Alpaca identifier of the corporate action.
      - `isin` string: International Securities Identification Number (ISIN) as defined by ISO 6166. May be empty for US corporate actions.
      - `process_date` string, date, required: The date when the corporate action is processed by Alpaca.
      - `symbol` string, required
  - `next_page_token` string, nullable, required: Pagination token for the next page.

## Other responses

- `400`: One of the request parameters is invalid. See the returned message for details.
- `401`: Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.
- `403`: The requested resource is forbidden.
- `429`: Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500`: Internal server error. We recommend retrying these later. If the issue persists, please contact us on [Slack](https://alpaca.markets/slack) or on the [Community Forum](https://forum.alpaca.markets/).

---

[API](https://skmtc.dev/alpacahq/apis/market-data-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/market-data-api/revisions/82f96f2d0134?raw)