> For the complete documentation index, see [llms.txt](https://twelvedata.com/docs/llms.txt).

# Dividends calendar

**Endpoint:** `GET https://api.twelvedata.com/dividends_calendar`

The dividends calendar endpoint provides a detailed schedule of upcoming and past dividend events for specified date ranges. By using the `start_date` and `end_date` parameters, users can retrieve a list of companies issuing dividends, including the ex-dividend date and dividend amount. This endpoint is ideal for tracking dividend payouts and planning investment strategies based on dividend schedules.

**API credits cost:** `40` per symbol

> **Note:** This API endpoint is available on the [Grow](https://twelvedata.com/pricing) plan (individual) and the [Venture](https://twelvedata.com/pricing-business) plan (business) and above.

## Parameters

- `symbol` (string, optional)
  Symbol ticker of instrument. For preferred stocks use dot(.) delimiter.
  E.g. `BRK.A` or `BRK.B` will be correct
  Example value: `AAPL`

- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the [Ultra](https://twelvedata.com/pricing) plan (individual) and the [Enterprise](https://twelvedata.com/pricing-business) plan (business) and above.
  Example value: `BBG000B9Y5X2`

- `isin` (string, optional)
  Look up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the [ISIN Data add-on](https://twelvedata.com/account/add-ons).
  Example value: `US0378331005`

- `cusip` (string, optional)
  Look up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the [CUSIP Data add-on](https://twelvedata.com/account/add-ons).
  Example value: `594918104`

- `exchange` (string, optional)
  Exchange where instrument is traded
  Example value: `NASDAQ`

- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard
  Example value: `XNAS`

- `country` (string, optional)
  Country where instrument is traded, e.g., `United States` or `US`
  Example value: `US`

- `start_date` (string, optional)
  Start date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. Format `2006-01-02`
  Example value: `2024-01-01`

- `end_date` (string, optional)
  End date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format `2006-01-02`
  Example value: `2024-12-31`

- `outputsize` (integer, optional)
  Number of data points to retrieve.
  Supports values in the range from `1` to `500`.
  Default `100` when no date parameters are set, otherwise set to maximum
  Default value: `100`

- `page` (integer, optional)
  Page number
  Default value: `1`


## Response

- `` (array of object)
  - `symbol` (string)
    Ticker symbol of instrument
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `exchange` (string)
    Exchange where instrument is traded
  - `ex_date` (string)
    Stands for the ex date
  - `amount` (number)
    Dividend payment amount


## Example Request

```bash
curl "https://api.twelvedata.com/dividends_calendar?apikey=your_api_key"
```

## Example Response

```json
[
    {
        "symbol": "MSFT",
        "mic_code": "XNGS",
        "exchange": "NASDAQ",
        "ex_date": "2024-02-14",
        "amount": 0.75
    }
]
```
