# stocks_get_corporate_actions Typed corporate-action events for one US public company. | Field | Value | | --- | --- | | Category | Stocks (`stocks`) | | Exposure | mixed | | MCP tool | `stocks_get_corporate_actions` | | Documentation | https://www.agentdatasets.com/docs/tools/stocks_get_corporate_actions | ## Public-key response Provider-sourced dividend and split events are omitted for public keys; the response flags the omission via meta.restricted_omitted. ## Description 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)`. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | ticker_or_cik | input | `string` | yes | — | — | A US public company by ticker symbol ('AAPL', 'BRK.B') or SEC CIK ('320193'). Use this for dividends, splits, delistings, ticker changes, and notable 8-K M&A completion events. | | action_type | input | `string \| null` | no | null | — | Optional exact event type filter: 'dividend', 'split', 'delisting', 'ticker_change', or 'merger_acquisition'. Invalid values return bad_parameter. | | start_date | input | `string (date) \| null` | no | null | — | Earliest event date to include (inclusive, ISO YYYY-MM-DD). | | end_date | input | `string (date) \| null` | no | null | — | Latest event date to include (inclusive, ISO YYYY-MM-DD). | | limit | input | `integer` | no | 100 | min 1, max 1000 | Corporate-action events to return, newest first (1-1000). | | cursor | input | `string \| null` | no | null | — | Opaque pagination cursor from a previous response's `pagination.next_cursor`; omit to start from the newest event. | ## Provenance - `corporate_actions` — U.S. Securities and Exchange Commission (EDGAR), Canonical corporate-actions dataset identifier (`meta.source`); on the public surface, responses include only EDGAR filing-derived and ticker-era events — provider-sourced dividend/split events are omitted (U.S. Government work, public domain (17 U.S.C. § 105) for the EDGAR-derived events actually served on the public surface). See https://www.agentdatasets.com/docs/attribution.md - `sec-edgar-submissions` — U.S. Securities and Exchange Commission (EDGAR), Filing metadata only — form type, filing date, period of report, accession number, item codes — plus links to source documents on sec.gov; this connector never fetches or stores document contents (section extraction is `sec-edgar-archives`) (U.S. Government work, public domain (17 U.S.C. § 105)). See https://www.agentdatasets.com/docs/attribution.md - `sec-edgar-tickers` — U.S. Securities and Exchange Commission (EDGAR), Ticker-era corporate-action events derived from EDGAR ticker/company history (U.S. Government work, public domain (17 U.S.C. § 105)). See https://www.agentdatasets.com/docs/attribution.md - `tiingo` — provider-licensed source; not served to public keys Dataset registry: `stocks_corporate_actions`.