Skip to main content
Corporate actions cover dividends, stock splits, and similar events, with announcement, ex-, record, and payable dates. Only operating companies issue corporate actions; non-operating instruments return none.

​
Corporate actions

GET /corporate-actions
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
limitintegerNo50Page size (max 200).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/corporate-actions?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "corporate_actions": [
    {
      "id": "ca_...",
      "ticker": "AAPL",
      "action_type": "dividend",
      "announcement_date": "2026-02-01",
      "ex_date": "2026-02-09",
      "record_date": "2026-02-10",
      "payable_date": "2026-02-16",
      "details": { "amount": 0.25, "currency": "USD" }
    }
  ]
}