> ## Documentation Index
> Fetch the complete documentation index at: https://docs.davidhf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Corporate actions

> Dividends, splits, and other corporate actions.

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

```http theme={null}
GET /corporate-actions
```

| Parameter     | Type    | Required | Default | Description             |
| ------------- | ------- | -------- | ------- | ----------------------- |
| `scenario_id` | string  | Yes      | -       | The world to read from. |
| `ticker`      | string  | No       | all     | Restrict to one ticker. |
| `as_of`       | date    | No       | -       | Point-in-time cutoff.   |
| `limit`       | integer | No       | 50      | Page size (max 200).    |
| `offset`      | integer | No       | 0       | Pagination offset.      |

<CodeGroup>
  ```bash cURL theme={null}
  curl -s "https://api.davidhf.com/corporate-actions?scenario_id=<id>&ticker=AAPL" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  dd.corporate_actions.list(scenario_id="<id>", ticker="AAPL")
  ```
</CodeGroup>

```json theme={null}
{
  "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" }
    }
  ]
}
```