v1
latestOpenAPI 3.0.02026-07-26166415635.8 KBCorporate 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
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
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).
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.
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.
Sort data in ascending or descending order.
Response
OK
Example response
{
"corporate_actions": {
"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"
}
]
}
}