---
title: "Retrieve Announcements"
method: GET
path: "/v1/corporate_actions/announcements"
tags: ["Corporate Actions"]
deprecated: true
---

# Retrieve Announcements

`GET /v1/corporate_actions/announcements`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/corporate_actions/announcements`
- Auth: HTTP basic

> **Deprecated.**

This endpoint is deprecated, please use [the new corporate actions endpoint](https://docs.alpaca.markets/reference/corporateactions-1) instead.

## Query parameters

- `ca_types` string, required
- `since` string, date, required
- `until` string, date, required
- `symbol` string
- `cusip` string
- `date_type` 'declaration_date' | 'ex_date' | 'record_date' | 'payable_date'

## Response `200`

OK

- Announcement[]
  - `ca_sub_type` 'cash' | 'stock' | 'merger_update' | 'merger_completion' | 'stock_split' | 'until_split' | 'reverse_split' | 'recapitalization' | 'spinoff', required: Announcements have both a type and a subtype to categorize them. This model represents the lower level abstract "sub types" of Announcement. Please see the AnnouncementCAType model for higher level descriptions of the possible types Possible values are: - from the `dividend` type: - **cash** A cash payment based on the number of shares the account holds on the record date. - **stock** A stock payment based on the number of shares the account holds on the record date. - from the `merger` type: - **merger_update** An update to the terms of an upcoming merger. This can happen any number of times before the merger is completed and can be tracked by using the id parameter. - **merger_completion** A final update in the terms of the merger in which the initiating_symbol will acquire the target_symbol. Any previous terms updates for this announcement will have the same id value. - from the `split` type: - **stock_split** An increase in the number of shares outstanding with a decrease in the dollar value of each share. The new_rate and old_rate parameters will be returned in order to derive the ratio of the split. - **until_split** An increase in the number of shares outstanding with a decrease in the dollar value of each share. The new_rate and old_rate parameters will be returned in order to derive the ratio of the split. - **reverse_split** A decrease in the number of shares outstanding with an increase in the dollar value of each share. The new_rate and old_rate parameters will be returned in order to derive the ratio of the split. - **recapitalization** A stock recapitalization, typically used by a company to adjust debt and equity ratios. - from the `spinoff` type: - **spinoff** A disbursement of a newly tradable security when the initiating_symbol creates the target_symbol.
  - `ca_type` 'dividend' | 'merger' | 'split' | 'spinoff', required: Announcements have both a type and a subtype to categorize them. This model represents the higher level abstract "types" of Announcement. Please see the AnnouncementCASubType model for finer grain descriptions of the subtypes Possible values are: - dividend can have `cash` and `stock` subtypes - merger has `merger_update` and `merger_completion` sub types - split has `stock_split`, `until_split`, `reverse_split`, and `recapitalization` sub types - spinoff currently has only the `spinoff` subtype and thus is just this higher level category for now. A disbursement of a newly tradable security when the initiating_symbol creates the target_symbol.
  - `cash` string, nullable, required: The amount of cash to be paid per share held by an account on the record date.
  - `corporate_action_id` string, required: 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.
  - `declaration_date` string, required: Date the corporate action or subsequent terms update was announced.
  - `ex_date` string, nullable, required: The first date that purchasing a security will not result in a corporate action entitlement.
  - `id` string, required: ID that is specific to a single announcement.
  - `initiating_original_cusip` string, required: CUSIP of the company initiating the announcement.
  - `initiating_symbol` string, required: Symbol of the company initiating the announcement.
  - `new_rate` string, nullable, required: The numerator to determine any quantity change ratios in positions.
  - `old_rate` string, nullable, required: The denominator to determine any quantity change ratios in positions.
  - `payable_date` string, required: The date the announcement will take effect. On this date, account stock and cash balances are expected to be processed accordingly.
  - `record_date` string, nullable, required: The date an account must hold a settled position in the security in order to receive the corporate action entitlement.
  - `target_original_cusip` string, nullable, required: CUSIP of the child company involved in the announcement.
  - `target_symbol` string, nullable, required: Symbol of the child company involved in the announcement.

## Other responses

- `400`: Malformed input.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)