Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

fundamentals

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 ex-date, amount, and frequency. This endpoint is ideal for users tracking dividend histories or evaluating the income potential of stocks.

get/dividends

Query parameters

symbolstring

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

exchangestring

Exchange where instrument is traded

mic_codestring

Market Identifier Code (MIC) under ISO 10383 standard

countrystring

Country where instrument is traded, e.g., United States or US

range'last' | 'next' | '1m' | '3m' | '6m' | 'ytd' | '1y' | '2y' | '5y' | 'full'

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_datestring

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_datestring

End date for the dividend data query. Only dividends with dates on or before this date will be returned. Format 2006-01-02. If provided together with range parameter, range will take precedence.

adjustboolean

Specifies if there should be an adjustment

Response

Example response

{
  "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
    }
  ]
}