Announcement data is made available through the API as soon as it is ingested by Alpaca, which is typically the following trading day after the declaration date. This provides insight into future account stock position and cash balance changes that will take effect on an announcement’s payable date. Additionally, viewing previous announcement details can improve bookkeeping and reconciling previous account cash and position changes.

The CA Object

[
  {
    "id": "be3c368a-4c7c-4384-808e-f02c9f5a8afe",
    "corporate_actions_id": "F58684224_XY37",
    "ca_type": "Dividend",
    "ca_sub_type": "DIV",
    "initiating_symbol": "MLLAX",
    "initiating_original_cusip": "55275E101",
    "target_symbol": "MLLAX",
    "target_original_cusip": "55275E101",
    "declaration_date": "2021-01-05",
    "expiration_date": "2021-01-12",
    "record_date": "2021-01-13",
    "payable_date": "2021-01-14",
    "cash": "0.018",
    "old_rate": "1",
    "new_rate": "1"
  },
  {
    "corporate_action_id": "48251W104_AD21",
    "ca_type": "Dividend",
    "ca_sub_type": "cash",
    "initiating_symbol": "KKR",
    "initiating_original_cusip": "G52830109",
    "target_symbol": "KKR",
    "target_original_cusip": "G52830109",
    "declaration_date": "2021-11-01",
    "ex_date": "2021-11-12",
    "record_date": "2021-11-15",
    "payable_date": "2021-11-30",
    "cash": "0.145",
    "old_rate": "1",
    "new_rate": "1"
  }
]

Properties

Attribute	Type	Description
`id`	string	ID that is specific to a single announcement.
`corporate_action_id`	string	ID that remains consistent across all announcements for the same corporate action. Unlike `id`, this can be used to connect multiple announcements to see how the terms have changed throughout the lifecycle of the corporate action event.
`ca_type`	string	`dividend`, `merger`, `spinoff`, or `split`
`ca_sub_type`	string	When `ca_type = dividend`, then `cash` or `stock`. When `ca_type = merger`, then `merger_update` or `merger_completion`. When `ca_type = spinoff`, then `spinoff`. When `ca_type = split`, then `stock_split`, `unit_split`, `reverse_split`, or `recapitalization`.
`initiating_symbol`	string	Symbol of the company initiating the announcement.
`initiating_original_cusip`	string	CUSIP of the company initiating the announcement.
`target_symbol`	string	Symbol of the child company involved in the announcement.
`target_original_cusip`	string	CUSIP of the child company involved in the announcement.
`declaration_date`	string	Date the corporate action or subsequent terms update was announced.
`ex_date`	string	The first date that purchasing a security will not result in a corporate action entitlement.
`record_date`	string	The date an account must hold a settled position in the security in order to receive the corporate action entitlement.
`payable_date`	string	The date the announcement will take effect. On this date, account stock and cash balances are expected to be processed accordingly.
`cash`	string	The amount of cash to be paid per share held by an account on the record date.
`old_rate`	string	The denominator to determine any quantity change ratios in positions.
`new_rate`	string	The numerator to determine any quantity change ratios in positions.