Retrieve Announcements

GET {{baseUrl}}/v2/corporate_actions/announcements?ca_types=proident Ut&since=proident Ut&until=proident Ut

Returns announcements data given specified search criteria.

Request Params

KeyDatatypeRequiredDescription
ca_typesstring(Required) A comma-delimited list of Dividend, Merger, Spinoff, or Split.
sincestring(Required) The start (inclusive) of the date range when searching corporate action announcements. This should follow the YYYY-MM-DD format. The date range is limited to 90 days.
untilstring(Required) The end (inclusive) of the date range when searching corporate action announcements. This should follow the YYYY-MM-DD format. The date range is limited to 90 days.
symbolstringThe symbol of the company initiating the announcement.
cusipstringThe CUSIP of the company initiating the announcement.
date_typestringdeclaration_date, ex_date, record_date, or payable_date

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
Apca-Api-Key-Idstring
Apca-Api-Secret-Keystring

RESPONSES

status: OK

[{"id":"c228370f-e2a0-42ab-828e-43b869c25b6a","corporate_action_id":"2675879","ca_type":"split","ca_sub_type":"reverse_split","initiating_symbol":"","initiating_original_cusip":"","target_symbol":"WBBA","target_original_cusip":"64704E104","effective_date":"2024-01-08","ex_date":"2024-01-08","record_date":"2024-01-08","payable_date":"2024-01-08","cash":"0","old_rate":"100","new_rate":"1"},{"id":"dc938b64-8568-4e4d-b2bd-3327a2dde6d0","corporate_action_id":"2676107","ca_type":"split","ca_sub_type":"stock_split","initiating_symbol":"","initiating_original_cusip":"","target_symbol":"OMVKY","target_original_cusip":"670875202","effective_date":null,"ex_date":"2024-01-10","record_date":"2024-01-02","payable_date":"2024-01-09","cash":"0","old_rate":"1","new_rate":"4"},{"id":"9c1ac5ff-bfcf-419b-885b-7ee81ba3ac4d","corporate_action_id":"2675898","ca_type":"split","ca_sub_type":"stock_split","initiating_symbol":"","initiating_original_cusip":"","target_symbol":"CENTA","target_original_cusip":"153527205","effective_date":"2023-12-07","ex_date":"2024-02-09","record_date":"2024-01-08","payable_date":"2024-02-08","cash":"0","old_rate":"4","new_rate":"5"}]