Dividends

Dividends are distributions of a portion of a company’s profits to its shareholders, typically according to a schedule disclosed by the company. We provide the calendar of dividend payments for various companies.

By date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/dividends?d1=2023-01-01&d2=2024-01-01&c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getDividends(startDate='2023-01-01', endDate='2024-01-01')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/dividends?d1=2023-01-01&d2=2024-01-01&c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getDividends(start_date = '2023-01-01', end_date = '2024-01-01').then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/dividends?d1=2023-01-01&d2=2024-01-01&c=your_api_key");

/dividends/d1=yyyy-mm-dd&d2=yyyy-mm-dd

DateExSymbolNameActualDatePaymentCurrencyLastUpdate
2023-01-03CMCSA:USComcast0.272023-01-25USD9/27/2023
2023-01-04CPB:USCampbell Soup0.372023-01-30USD9/27/2023
2023-01-04CSCO:USCisco Systems0.382023-01-25USD9/27/2023

/dividends/d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=json

[{"DateEx":"2023-01-03","Symbol":"CMCSA:US            ","Name":"Comcast","Actual":0.27,"DatePayment":"2023-01-25","Currency":"USD","LastUpdate":"2023-09-27T19:03:00"},{"DateEx":"2023-01-04","Symbol":"CPB:US              ","Name":"Campbell Soup","Actual":0.37,"DatePayment":"2023-01-30","Currency":"USD","LastUpdate":"2023-09-27T19:15:00"},{"DateEx":"2023-01-04","Symbol":"CSCO:US             ","Name":"Cisco Systems","Actual":0.38,"DatePayment":"2023-01-25","Currency":"USD","LastUpdate":"2023-09-27T19:20:00"}]

/dividends/d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=csv

DateEx,Symbol,Name,Actual,DatePayment,Currency,LastUpdate
2023-01-03,CMCSA:US            ,Comcast,0.27,2023-01-25,USD,9/27/2023 7:03:00 PM
2023-01-04,CPB:US              ,Campbell Soup,0.37,2023-01-30,USD,9/27/2023 7:15:00 PM
2023-01-04,CSCO:US             ,Cisco Systems,0.38,2023-01-25,USD,9/27/2023 7:20:00 PM

/dividends/d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=xml

<ArrayOfDividendsItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<DividendsItem>
<Actual>0.27</Actual>
<Currency>USD</Currency>
<DateEx>2023-01-03</DateEx>
<DatePayment>2023-01-25</DatePayment>
<LastUpdate>2023-09-27T19:03:00</LastUpdate>
<Name>Comcast</Name>
<Symbol>CMCSA:US </Symbol>
</DividendsItem>
<DividendsItem>
<Actual>0.37</Actual>
<Currency>USD</Currency>
<DateEx>2023-01-04</DateEx>
<DatePayment>2023-01-30</DatePayment>
<LastUpdate>2023-09-27T19:15:00</LastUpdate>
<Name>Campbell Soup</Name>
<Symbol>CPB:US </Symbol>
</DividendsItem>
<DividendsItem>
<Actual>0.38</Actual>
<Currency>USD</Currency>
<DateEx>2023-01-04</DateEx>
<DatePayment>2023-01-25</DatePayment>
<LastUpdate>2023-09-27T19:20:00</LastUpdate>
<Name>Cisco Systems</Name>
<Symbol>CSCO:US </Symbol>
</DividendsItem>
</ArrayOfDividendsItem>

By date and symbol

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/dividends/symbol/aapl:us?d1=2023-01-01&d2=2024-01-01&c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getDividends(symbol = 'aapl:us', startDate='2023-01-01', endDate='2024-01-01')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/dividends/symbol/aapl:us?d1=2023-01-01&d2=2024-01-01&c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getDividends(symbol = 'aapl:us', start_date = '2023-01-01', end_date = '2024-01-01').then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/dividends/symbol/aapl:us?d1=2023-01-01&d2=2024-01-01&c=your_api_key");

/dividends/symbol/{symbol}?d1=yyyy-mm-dd&d2=yyyy-mm-dd

DateExSymbolNameActualDatePaymentCurrencyLastUpdate
2023-02-10AAPL:USApple0.232023-02-16USD9/27/2023 5:21:00 PM
2023-05-12AAPL:USApple0.242023-05-18USD9/27/2023 5:21:00 PM
2023-08-11AAPL:USApple0.24023-08-17USD9/27/2023 5:21:00 PM

/dividends/symbol/{symbol}?d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=json

[{"DateEx":"2023-02-10","Symbol":"AAPL:US             ","Name":"Apple","Actual":0.23,"DatePayment":"2023-02-16","Currency":"USD","LastUpdate":"2023-09-27T17:21:00"},{"DateEx":"2023-05-12","Symbol":"AAPL:US             ","Name":"Apple","Actual":0.24,"DatePayment":"2023-05-18","Currency":"USD","LastUpdate":"2023-09-27T17:21:00"},{"DateEx":"2023-08-11","Symbol":"AAPL:US             ","Name":"Apple","Actual":0.24,"DatePayment":"2023-08-17","Currency":"USD","LastUpdate":"2023-09-27T17:21:00"}]

/dividends/symbol/{symbol}?d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=csv

DateEx,Symbol,Name,Actual,DatePayment,Currency,LastUpdate
2023-02-10,AAPL:US             ,Apple,0.23,2023-02-16,USD,9/27/2023 5:21:00 PM
2023-05-12,AAPL:US             ,Apple,0.24,2023-05-18,USD,9/27/2023 5:21:00 PM
2023-08-11,AAPL:US             ,Apple,0.24,2023-08-17,USD,9/27/2023 5:21:00 PM

/dividends/symbol/{symbol}?d1=yyyy-mm-dd&d2=yyyy-mm-dd&f=xml

<ArrayOfDividendsItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<DividendsItem>
<Actual>0.23</Actual>
<Currency>USD</Currency>
<DateEx>2023-02-10</DateEx>
<DatePayment>2023-02-16</DatePayment>
<LastUpdate>2023-09-27T17:21:00</LastUpdate>
<Name>Apple</Name>
<Symbol>AAPL:US </Symbol>
</DividendsItem>
<DividendsItem>
<Actual>0.24</Actual>
<Currency>USD</Currency>
<DateEx>2023-05-12</DateEx>
<DatePayment>2023-05-18</DatePayment>
<LastUpdate>2023-09-27T17:21:00</LastUpdate>
<Name>Apple</Name>
<Symbol>AAPL:US </Symbol>
</DividendsItem>
<DividendsItem>
<Actual>0.24</Actual>
<Currency>USD</Currency>
<DateEx>2023-08-11</DateEx>
<DatePayment>2023-08-17</DatePayment>
<LastUpdate>2023-09-27T17:21:00</LastUpdate>
<Name>Apple</Name>
<Symbol>AAPL:US </Symbol>
</DividendsItem>
</ArrayOfDividendsItem>

Response fields

FieldTypeDescriptionExample
DateExstringDate on or after which a purchaser of a stock is not entitled to receive the upcoming dividend payment“2023-01-03”
SymbolstringUnique symbol used by Trading Economics“CMCSA:US”
NamestringCompany name“Comcast”
ActualnumberActual value0.27
DatePaymentstringDate on which the company distributing the dividend actually pays it to the shareholders“2023-01-25”
CurrencystringDividend currency“USD”
LastUpdatestringLatest update time“9/27/2023 7:03:00 PM”