latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

fundamentals

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.

get/dividends_calendar

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

start_datestring

Start date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. Format 2006-01-02

end_datestring

End date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format 2006-01-02

outputsizeinteger

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

pageinteger

Page number

Response

symbolstring

Ticker symbol of instrument

mic_codestring

Market identifier code (MIC) under ISO 10383 standard

exchangestring

Exchange where instrument is traded

ex_datestring required

Stands for the ex date

amountnumber double required

Dividend payment amount

Example response

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