Retrieve Announcements

get

https://broker-api.sandbox.alpaca.markets/v1/corporate_actions/announcements

This enables searching for an array of corporate action announcements based on criteria.

Query Params

ca_types

string

required

A comma-delimited list of CorporateActionType values

since

date

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.

until

date

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.

symbol

string

The symbol of the company initiating the announcement.

cusip

string

The CUSIP of the company initiating the announcement.

date_type

string

enum

An emum of possible ways to use the since and until parameters to search by.

the types are:

declaration_date: The date of the preliminary announcement details or the date that any subsequent term updates took place.
ex_date: The date on which any security purchasing activity will not result in a corporate action entitlement. Any selling activity that takes place on or after this date will result in a corporate action entitlement.
record_date: The date the company checks its records to determine who is shareholder in order to allocate entitlements.
payable_date: The date that the stock and cash positions will update according to the account positions as of the record date.

Allowed:

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Malformed input.