Corporate Actions: Splits and Dividends API

Corporate actions rewrite a price series after the fact. A dividend takes cash out of the share price on the ex-date; a split multiplies the share count and divides the price. Get either one wrong and a backtest, a yield calculation or a total-return chart is quietly wrong with it. This API gives you both histories for a single instrument in one request: every dividend with its amount, its currency and its declaration, record and payment dates, and every split with its exact ratio.

History is deep. For the longest-running US payers the record starts in 1970 — Procter & Gamble on 19 January 1970 is the earliest dividend found anywhere in our sampling, and the same floor holds for Johnson & Johnson, General Electric, IBM, Exxon and Coca-Cola. That is more than fifty-five years and, for Coca-Cola, 226 individual payments in one response. Splits go back almost as far: Procter & Gamble on 19 May 1970.

Dividends History API

https://eodhd.com/api/div/{SYMBOL}?api_token=YOUR_API_TOKEN&fmt=json

Path Parameter

Query Parameters

Request Example

URL cURL PHP Python R Chat GPT

https://eodhd.com/api/div/AAPL.US?from=2026-05-01&api_token=demo&fmt=json

(Sign up for free to get an API token)

curl --location "https://eodhd.com/api/div/AAPL.US?from=2026-05-01&api_token=demo&fmt=json"

(Sign up for free to get an API token)

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/div/AAPL.US?from=2026-05-01&api_token=demo&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

(Sign up for free to get an API token)

import requests

url = f'https://eodhd.com/api/div/AAPL.US?from=2026-05-01&api_token=demo&fmt=json'
data = requests.get(url).json()

print(data)

(Sign up for free to get an API token)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/div/AAPL.US?from=2026-05-01&api_token=demo&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

(Sign up for free to get an API token)

New to coding? Our ChatGPT assistant can generate code in any language tailored to our API. Simply describe how you want to use our data, and get a working piece of code. Don’t forget to replace the API token with your own.

Try it now (it's free)!

How to use it (YouTube)

Response Example

[
    {
        "date": "2026-05-11",
        "declarationDate": "2026-04-30",
        "recordDate": "2026-05-11",
        "paymentDate": "2026-05-14",
        "period": "Quarterly",
        "value": 0.27,
        "unadjustedValue": 0.27,
        "currency": "USD"
    },
    {
        "date": "2026-08-10",
        "declarationDate": "2026-07-30",
        "recordDate": "2026-08-10",
        "paymentDate": "2026-08-13",
        "period": "Quarterly",
        "value": 0.27,
        "unadjustedValue": 0.27,
        "currency": "USD"
    }
]

Response Fields

Adjusted versus unadjusted amounts

Two money fields come back for every payment, and mixing them up is the most expensive mistake you can make on this endpoint. unadjustedValue is the historical fact: what one share received on that day. value is that same payment restated in today’s shares, divided by every split that has happened since.

Apple makes the arithmetic visible. Its dividend on 11 May 1987 comes back as unadjustedValue 0.12096 and value 0.00054 — a ratio of exactly 224, which is the product of all five Apple splits since: 2 × 2 × 2 × 7 × 4. The next payment, on 10 August 1987, sits just after the first of those splits, and its ratio is 112. Closer to the present, the payment of 8 May 2020 reads unadjustedValue 0.82 against value 0.205 — a ratio of exactly 4, the 4-for-1 split of that August — while the payment of 6 November 2020, the first one after it, has both fields at 0.205. From there to today they stay identical, because no split has happened since.

How far the extended dates reach

Every record everywhere carries the ex-date, the amount, the unadjusted amount and the currency. The three extra dates thin out as you move away from North America. Measured over dividends since 2015 for a twenty-ticker global sample:

So treat declarationDate, recordDate, paymentDate and period as optional fields rather than guaranteed ones, and null-check them before you use them in a join. Coverage is best on US and Canadian names, thinnest on the Indian and Korean exchanges.

Historical Splits API

https://eodhd.com/api/splits/{SYMBOL}?api_token=YOUR_API_TOKEN&fmt=json

The splits endpoint takes exactly the same parameters as the dividends endpoint — the same symbol format, the same inclusive from and to, the same case-sensitive fmt defaulting to csv — and costs the same single API call.

Request Example

URL cURL PHP Python R Chat GPT

https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json

(Sign up for free to get an API token)

curl --location "https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json"

(Sign up for free to get an API token)

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

(Sign up for free to get an API token)

import requests

url = f'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
data = requests.get(url).json()

print(data)

(Sign up for free to get an API token)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

(Sign up for free to get an API token)

New to coding? Our ChatGPT assistant can generate code in any language tailored to our API. Simply describe how you want to use our data, and get a working piece of code. Don’t forget to replace the API token with your own.

Try it now (it's free)!

How to use it (YouTube)

Response Example

[
    {
        "date": "2000-06-21",
        "split": "2.000000/1.000000"
    },
    {
        "date": "2005-02-28",
        "split": "2.000000/1.000000"
    },
    {
        "date": "2014-06-09",
        "split": "7.000000/1.000000"
    },
    {
        "date": "2020-08-31",
        "split": "4.000000/1.000000"
    }
]

Response Fields

Reading the split ratio

The string is new over old: how many shares you end up with, over how many you started with. Divide the first number by the second and you get the factor the share count is multiplied by — and the factor the price is divided by.

A numerator larger than the denominator is a forward split; smaller is a reverse split.

Dates, formats and error handling

Both endpoints share one date parser and one error surface. The behaviour below was measured on both.

Both bounds are inclusive. Apple’s dividend of 11 May 2026 is returned by a request with from and to both set to 2026-05-11, and disappears when both are moved to 2026-05-12.

The date parser is lenient, and that is the danger. Values like 2020/01/01, 20200101, 2020-1-1 and 2020-01-01T00:00:00 are all accepted and all resolve to 1 January 2020. But a value it cannot read is not rejected either — it silently produces an empty array with HTTP 200. A US-style from=01/01/2020 returns no rows at all, and so does the impossible from=2020-13-45. There is no validation error to catch, so a date-format bug in your client looks exactly like a company that never paid a dividend.

Status codes

Sign up & Get Data

Coverage and depth of history

Both feeds follow the equity universe: stocks and funds on the exchanges listed by the Exchanges API, across the US, Canada, Europe, Asia, Australia and Latin America. ETFs and mutual funds are included and distribute normally — Vanguard Total Stock Market pays back to 2001 in the feed, and the SPDR S&P 500 ETF returns a full record set. Instruments that cannot have corporate actions — crypto, forex, indices, government bonds — return an empty array rather than an error, which makes them safe to include in a bulk loop.

On depth, nothing in our sampling predates 1970, and several of the oldest US payers start within the first half of that year, which suggests the dataset floor rather than the companies’ own first payments. Typical full histories: Coca-Cola 226 dividends from June 1970, Johnson & Johnson 227 from February 1970, McDonald’s 208 from May 1976, Apple 92 from May 1987, Microsoft 91 from February 2003.

Where to go next

Corporate actions are rarely the whole job. Prices for the same instrument, already split- and dividend-adjusted in the adjusted_close field, come from the End-of-Day API at one call per ticker — if all you need is an adjusted series, you may not need this API at all; you need it when you want the events themselves. Every split and every dividend across a whole exchange on a single date is the Bulk API, at 100 calls per exchange. Events that are announced but still ahead — including forthcoming ex-dates — are in the Calendar API.

For payout ratios, dividend yield and the rest of the company picture, see Fundamental Data — and note that its General.CurrencyCode field is what tells you whether a quote is in pence or pounds. To find valid exchange codes and tickers, use the Exchanges API. To see how the one-call charge sits against your daily allowance, see API Limits.