stocks_get_corporate_actions

Typed corporate-action events for one US public company.

Returns the shared envelope. data echoes identity (ticker, cik, company_name), the requested action_type filter, and a bounded newest-first actions list. Event types are dividend (amount/currency, ex-date as event_date), split (ratio, execution date), delisting (Form 25/25-NSE filing date and accession), ticker_change (details with from_symbol/to_symbol), and merger_acquisition (8-K filing date, accession, and raw curated item codes such as 2.01,9.01). Fields that do not apply to an event's type (or that the source does not provide, like record_date/pay_date) are null.

Use this for event history; use stocks_get_historical_prices for OHLCV performance and stocks_get_sec_filings when you need the underlying filing links. The merger_acquisition rows here also appear as ma_completion events on stocks_get_company_events (derived from the same 8-K accessions); this tool stays the owner of curated corporate-action history. meta.source is the canonical dataset corporate_actions; each event's source carries connector attribution. On the public surface, restricted-source events are omitted and listed in meta.restricted_omitted; internal credentials receive all events. Provider-derived dividends/splits from Tiingo are internal-use-only and flagged non_redistributable per event and on meta when present.

Bounds: default 100, max 1000 events per page. To page, pass pagination.next_cursor back as cursor. Errors carry machine codes: unknown_entity for unknown ticker/CIK and bad_parameter for invalid action type, date range, non-ticker input, limit, or cursor.

Example: stocks_get_corporate_actions(ticker_or_cik="AAPL", action_type="dividend", limit=5).