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

# Corporate actions

`GET /v1/corporate-actions`

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

> ⚠️ 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
- `page_token` string
- `sort` 'asc' | 'desc' — Sort data in ascending or descending order.

## Response `200`

OK

- CorporateActionsResp
  - `corporate_actions` CorporateActions, 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.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/versions/62e3378bb273/schema)