Corporate actions
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.
Request
- Base URLhttps://data.giftcity.in.alpaca.markets
- URLhttps://data.giftcity.in.alpaca.markets/v1/corporate-actions
- Auth
- API key in header APCA-API-KEY-ID and API key in header APCA-API-SECRET-KEY
- or HTTP basic
Query parameters
A comma-separated list of symbols.
A comma-separated list of CUSIPs.
A comma-separated list of types. If not provided, search all types.
The following types are supported:
- reverse_split
- forward_split
- unit_split
- cash_dividend
- stock_dividend
- spin_off
- cash_merger
- stock_merger
- stock_and_cash_merger
- redemption
- name_change
- worthless_removal
- rights_distribution
- partial_call
- reorganization
- capital_gains_distribution
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
The region to filter corporate actions by.
The inclusive start of the interval. The corporate actions are sorted by their process_date. Format: YYYY-MM-DD. Default: current day.
The inclusive end of the interval. The corporate actions are sorted by their process_date. Format: YYYY-MM-DD. Default: current day.
A comma-separated list of corporate action IDs. This parameter is mutually exclusive with all other filters (symbols, types, start, end, region, data_quality).
Maximum number of corporate actions to return in a response. The limit applies to the total number of data points, not the count per symbol! Use next_page_token to fetch the next set of corporate actions.
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.
Controls which corporate actions are returned based on data quality.
The pagination token from which to continue. The value to pass here is returned in specific requests when more data is available, usually because of a response result limit.
Sort data in ascending or descending order.
Response
OK
Example response
{
"corporate_actions": {
"capital_gains_distributions": [
{
"currency": "USD",
"cusip": "36261K509",
"ex_date": "2025-12-26",
"id": "98c905a1-08c7-450c-8669-b8e7aee8b44d",
"isin": "US36261K5090",
"long_term_rate": 0.45855,
"payable_date": "2026-01-09",
"process_date": "2026-01-08",
"record_date": "2025-12-29",
"short_term_rate": 0.11019,
"symbol": "GCAD"
}
],
"cash_dividends": [
{
"cusip": "319829107",
"ex_date": "2023-05-04",
"foreign": false,
"id": "11cfd108-292e-4cc6-bfbf-5999cdbc4029",
"payable_date": "2023-05-19",
"process_date": "2023-05-19",
"rate": 0.125,
"record_date": "2023-05-05",
"special": false,
"symbol": "FCF"
}
],
"cash_mergers": [
{
"acquiree_cusip": "Y2687W108",
"acquiree_symbol": "GLOP",
"effective_date": "2023-07-17",
"id": "3772bbd7-4ad5-44d4-9cc0-f69156a2f8f5",
"payable_date": "2023-07-17",
"process_date": "2023-07-17",
"rate": 5.37
}
],
"forward_splits": [
{
"cusip": "816851109",
"due_bill_redemption_date": "2023-08-23",
"ex_date": "2023-08-22",
"id": "189bd849-ab9f-4b4d-aaaa-a6d415fd976d",
"new_rate": 2,
"old_rate": 1,
"payable_date": "2023-08-21",
"process_date": "2023-08-22",
"record_date": "2023-08-14",
"symbol": "SRE"
}
],
"name_changes": [
{
"id": "5a774c35-edec-4532-a812-a56d0bbb623a",
"new_cusip": "Y9390M103",
"new_symbol": "VFS",
"old_cusip": "G11537100",
"old_symbol": "BSAQ",
"process_date": "2023-08-15"
}
],
"redemptions": [
{
"cusip": "687305102",
"id": "395da031-0e57-4918-a6fb-64a7c713aca4",
"payable_date": "2023-06-13",
"process_date": "2023-06-13",
"rate": 0.141134,
"symbol": "ORPHY"
}
],
"reverse_splits": [
{
"ex_date": "2023-08-24",
"id": "913de862-c02c-46dc-a89c-fc8779a50d30",
"new_cusip": "60879E200",
"new_rate": 1,
"old_cusip": "60879E101",
"old_rate": 50,
"process_date": "2023-08-24",
"record_date": "2023-08-24",
"symbol": "MNTS"
}
],
"rights_distributions": [
{
"ex_date": "2024-04-17",
"expiration_date": "2024-05-14",
"id": "69794cfd-0adc-4e11-9211-9210a9cf8932",
"new_cusip": "454089111",
"new_symbol": "IFN.RTWI",
"payable_date": "2024-04-19",
"process_date": "2024-04-19",
"rate": 1,
"record_date": "2024-04-18",
"source_cusip": "454089103",
"source_symbol": "IFN"
}
],
"spin_offs": [
{
"ex_date": "2023-08-15",
"id": "82e602f6-35bc-4651-a5dd-f6d88ff37c55",
"new_cusip": "85237B101",
"new_rate": 1,
"new_symbol": "SRM",
"process_date": "2023-08-15",
"record_date": "2023-08-15",
"source_cusip": "48208F105",
"source_rate": 19.35,
"source_symbol": "JUPW"
}
],
"stock_and_cash_mergers": [
{
"acquiree_cusip": "561409103",
"acquiree_rate": 1,
"acquiree_symbol": "MLVF",
"acquirer_cusip": "31931U102",
"acquirer_rate": 0.7733,
"acquirer_symbol": "FRBA",
"cash_rate": 7.8,
"effective_date": "2023-07-18",
"id": "e5248356-2c06-42cf-aeb9-1595bd616cdb",
"payable_date": "2023-07-18",
"process_date": "2023-07-18"
}
],
"stock_dividends": [
{
"cusip": "605015106",
"ex_date": "2023-05-19",
"id": "3ae94c30-2d37-473a-bf29-5f7b4ab6d3ca",
"payable_date": "2023-05-05",
"process_date": "2023-05-19",
"rate": 0.05,
"record_date": "2023-05-22",
"symbol": "MSBC"
}
],
"stock_mergers": [
{
"acquiree_cusip": "53223X107",
"acquiree_rate": 1,
"acquiree_symbol": "LSI",
"acquirer_cusip": "30225T102",
"acquirer_rate": 0.895,
"acquirer_symbol": "EXR",
"effective_date": "2023-07-20",
"id": "728f8cb2-a00e-4bc7-ad14-d15fe82bbcff",
"payable_date": "2023-07-20",
"process_date": "2023-07-20"
}
],
"unit_splits": [
{
"alternate_cusip": "G5391L110",
"alternate_rate": 0.3333,
"alternate_symbol": "LVROW",
"effective_date": "2023-03-01",
"id": "3e68e87e-ae95-4d68-91d1-715d52ef143a",
"new_cusip": "G5391L102",
"new_rate": 1,
"new_symbol": "LVRO",
"old_cusip": "G8990L119",
"old_rate": 1,
"old_symbol": "TPBAU",
"process_date": "2023-03-01"
}
],
"worthless_removals": [
{
"cusip": "078771300",
"id": "106c2149-ee04-4d2e-a943-98dbb4d21a3c",
"process_date": "2024-12-19",
"symbol": "BLPH"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.