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

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=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(symbols = '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

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	023-08-17	USD	9/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

Field	Type	Description	Example
DateEx	string	Ex-dividend date — the date on or after which buyers are not entitled to the upcoming dividend	“2023-01-03”
Symbol	string	Unique Trading Economics symbol identifying the company	“CMCSA:US”
Name	string	Company name	“Comcast”
Actual	number	Dividend per share declared by the company	0.27
DatePayment	string	Payment date — the date the dividend is actually paid to shareholders	“2023-01-25”
Currency	string	Currency in which the dividend is paid	“USD”
LastUpdate	string	Timestamp of the latest data update in UTC	“2023-09-27T19:03:00”