# Dividends

The dividends endpoint provides historical dividend data for a specified stock, in many cases covering over a decade. It returns information on dividend payouts, including the amount, payment date, and frequency. This endpoint is ideal for users tracking dividend histories or evaluating the income potential of stocks.

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

> **Note:** This API endpoint is available starting with the [Grow](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. `BRK.A` or `BRK.B` will be correct


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `exchange` (string, optional)
  Exchange where instrument is traded


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


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


- `range` (string, optional)
  Specifies the time range for which to retrieve dividend data.
Accepts values such as `last` (most recent dividend), `next` (upcoming dividend),
`1m` - `5y` for respective periods, or `full` for all available data.
If provided together with `start_date` and/or `end_date`, this parameter takes precedence.


- `start_date` (string, optional)
  Start date for the dividend data query. Only dividends with dates on or after this date will be returned. Format `2006-01-02`.
If provided together with `range` parameter, `range` will take precedence.


- `end_date` (string, optional)
  End date for the dividend data query. Only dividends with dates on or after this date will be returned. Format `2006-01-02`.
If provided together with `range` parameter, `range` will take precedence.


- `adjust` (boolean, optional)
  Specifies if there should be an adjustment


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Json object with request general information
  - `symbol` (string)
    Ticker symbol of instrument
  - `name` (string)
    Name of symbol
  - `currency` (string)
    Currency in which instrument is traded
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `exchange_timezone` (string)
    Timezone of the exchange

- `dividends` (array of object)
  List of dividends
  - `ex_date` (string)
    Stands for the ex date
  - `amount` (number)
    Stands for the payment amount


## Example Request

```bash
curl "https://api.twelvedata.com/dividends?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "exchange_timezone": "America/New_York"
    },
    "dividends": [
        {
            "ex_date": "2021-08-06",
            "amount": 0.22
        }
    ]
}
```