ESC to close

Dividends

Get historical dividend payments, ex-dividend dates, and calculated daily dividend yields.

GET https://data.businessquant.com/dividends?{identifier}&mode={mode}&api_key={api_key}

Parameters

Retrieve comprehensive historical dividend payment histories, ex-dividend dates, and trailing twelve-month (TTM) calculations. You must provide an API key, and you must provide exactly one Identifier (Ticker, CIK, or Series ID). You can toggle the mode to fetch either dividend per share (dps) or dividend yields (divyield).

Parameter Description
api_key
Required
Your unique API key for authentication.
ticker
Conditional Identifier
Stock Ticker. (Provide exactly one identifier: ticker, cik, or seriesid).
Format: ticker=AAPL
cik
Conditional Identifier
CIK Number. (Provide exactly one identifier: ticker, cik, or seriesid).
Format: cik=320193
seriesid
Conditional Identifier
Series ID, primarily used for mutual funds and ETFs.
Format: seriesid=S000009189
mode
Optional
Data mode: dps (Dividend Per Share) or divyield (Dividend Yield). Default is dps.
Format: mode=dps
Example cURL Request
curl -X GET "https://data.businessquant.com/dividends?ticker=AAPL&mode=dps&api_key=YOUR_API_KEY"
Sample Response (DPS Mode)
{
    "metadata": {
        "cik": 320193,
        "ticker": "AAPL",
        "id_series": null,
        "companyname": "Apple Inc.",
        "companyname_short": "Apple",
        "range": "2012-2026",
        "divyield": 0.003985249703192581,
        "lastdividend": "2026-02-12",
        "nextdividend": null,
        "ttmdividend": 1.04,
        "mode": "dps"
    },
    "data": [
        {
            "dividend": 0.26,
            "ex_date": "2026-02-09",
            "payment_date": "2026-02-12"
        },
        {
            "dividend": 0.26,
            "ex_date": "2025-11-10",
            "payment_date": "2025-11-13"
        },
        {
            "dividend": 0.26,
            "ex_date": "2025-08-11",
            "payment_date": "2025-08-14"
        },
        {
            "dividend": 0.26,
            "ex_date": "2025-05-12",
            "payment_date": "2025-05-15"
        },
        {
            "dividend": 0.25,
            "ex_date": "2025-02-10",
            "payment_date": "2025-02-13"
        },
        {
            "dividend": 0.25,
            "ex_date": "2024-11-08",
            "payment_date": "2024-11-14"
        },
        ...
    ]
}
Sample Response (Yield Mode)
{
    "metadata": {
        "cik": 320193,
        "ticker": "AAPL",
        "id_series": null,
        "companyname": "Apple Inc.",
        "companyname_short": "Apple",
        "range": "2012-2026",
        "divyield": 0.003985249703192581,
        "lastdividend": "2026-02-12",
        "nextdividend": null,
        "ttmdividend": 1.04,
        "mode": "divyield"
    },
    "data": [
        {
            "reportperiod": "2009-03-30",
            "value": 0.0
        },
        {
            "reportperiod": "2009-03-31",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-01",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-02",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-03",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-06",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-07",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-08",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-09",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-13",
            "value": 0.0
        },
        {
            "reportperiod": "2009-04-14",
        ...
    ]
}

Endpoint Variations

Below are the distinct ways to formulate your request. You can copy these directly into your application.

1. By Ticker (DPS)
https://data.businessquant.com/dividends?ticker=AAPL&mode=dps&api_key=YOUR_API_KEY
2. By CIK (Yield)
https://data.businessquant.com/dividends?cik=320193&mode=divyield&api_key=YOUR_API_KEY
3. By Series ID (Fund DPS)
https://data.businessquant.com/dividends?seriesid=S000009189&mode=dps&api_key=YOUR_API_KEY