getEarningsAndDividendsCalendar API

getEarningsAndDividendsCalendar

The getEarningsAndDividendsCalendar API provides the total number of upcoming earnings and dividends by date. And will also return the earnings and dividends for the requested date. Please note that the output of this API will change based on the type of data requested. When requesting 'totals' (default type), it will return the date and total earnings and dividends for that date, when requesting 'earnings' it will return earnings data for all symbols for the requested start date, when requesting 'dividends' it will return dividend data for all symbols for the requested start date. And if the request type is 'earnings-dividends' then the output will be and earnings attribute that will have an array of objects with earnings data and a dividends attribute with an array of objects with the dividends data.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

exchange^required

The exchange(s) for which the data is requested. US-ALL and CA-ALL will query for all permitted US and Canadian exchanges for your account.

Type

enum (A type which includes a list of valid possible values.)

Default

US-ALL

Valid Values

US-ALL, CA-ALL, AMEX, NASDAQ, NYSE, OTHER OTC, TSX, TSX-V, CNSX

type^required

A boolean parameter that when set to true, will return all earnings and dividends data for the requested start date. If no start date is passed, it will return the data for the current date.

Type

enum (A type which includes a list of valid possible values.)

Default

totals

Valid Values

totals, earnings, dividends, earnings-dividends

startDate^optional

The start date for earnings and dividends total and the date for which the earnings and dividends information will be returned.

Type

date (A date in the format of YYYY-MM-DD.)

Default

2025-11-11

endDate^optional

The end date for earnings and dividends total. This input parameter is ignored when requesting the actual earnings or dividends or earnings and dividends information.

Type

date (A date in the format of YYYY-MM-DD.)

Default

2025-11-20

Outputs

date
always returned

The date for the data is returned.

date
A date in the format of YYYY-MM-DD.

totalEarnings
always returned

The total number of earnings data for the day.

int
A numeric type defining a whole number. (example: 2)

totalDividends
always returned

The total number of dividends data for the day.

int
A numeric type defining a whole number. (example: 2)

earnings

N/A

dividends

N/A

Status Code Responses

200

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.json?apikey=YOUR_API_KEY
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "date": "2025-11-11",
            "totalEarnings": 317,
            "totalDividends": 3
        },
        {
            "date": "2025-11-12",
            "totalEarnings": 437,
            "totalDividends": 35
        },
        {
            "date": "2025-11-13",
            "totalEarnings": 583,
            "totalDividends": 35
        },
        {
            "date": "2025-11-14",
            "totalEarnings": 136,
            "totalDividends": 122
        },
        {
            "date": "2025-11-17",
            "totalEarnings": 51,
            "totalDividends": 85
        },
        {
            "date": "2025-11-18",
            "totalEarnings": 113,
            "totalDividends": 25
        },
        {
            "date": "2025-11-19",
            "totalEarnings": 52,
            "totalDividends": 32
        },
        {
            "date": "2025-11-20",
            "totalEarnings": 58,
            "totalDividends": 23
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.xml?apikey=YOUR_API_KEY
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY

Response

<?xml version="1.0" encoding="utf-8"?>
<getEarningsAndDividendsCalendar>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <date>2025-11-11</date>
    <totalEarnings>317</totalEarnings>
    <totalDividends>3</totalDividends>
  </item>
  <item>
    <date>2025-11-12</date>
    <totalEarnings>437</totalEarnings>
    <totalDividends>35</totalDividends>
  </item>
  <item>
    <date>2025-11-13</date>
    <totalEarnings>583</totalEarnings>
    <totalDividends>35</totalDividends>
  </item>
  <item>
    <date>2025-11-14</date>
    <totalEarnings>136</totalEarnings>
    <totalDividends>122</totalDividends>
  </item>
  <item>
    <date>2025-11-17</date>
    <totalEarnings>51</totalEarnings>
    <totalDividends>85</totalDividends>
  </item>
  <item>
    <date>2025-11-18</date>
    <totalEarnings>113</totalEarnings>
    <totalDividends>25</totalDividends>
  </item>
  <item>
    <date>2025-11-19</date>
    <totalEarnings>52</totalEarnings>
    <totalDividends>32</totalDividends>
  </item>
  <item>
    <date>2025-11-20</date>
    <totalEarnings>58</totalEarnings>
    <totalDividends>23</totalDividends>
  </item>
</getEarningsAndDividendsCalendar>

CSV

GET

GET https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.csv?apikey=YOUR_API_KEY
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getEarningsAndDividendsCalendar.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY

Response

date,totalEarnings,totalDividends
"2025-11-11","317","3"
"2025-11-12","437","35"
"2025-11-13","583","35"
"2025-11-14","136","122"
"2025-11-17","51","85"
"2025-11-18","113","25"
"2025-11-19","52","32"
"2025-11-20","58","23"

PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
];

$result = $ondemand->getEarningsAndDividendsCalendar($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")

Set result = ondemand.getEarningsAndDividendsCalendar("YOUR_API_KEY")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getEarningsAndDividendsCalendar('YOUR_API_KEY');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = ondemand.service.getEarningsAndDividendsCalendar('YOUR_API_KEY')

print(result)

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getEarningsAndDividendsCalendar,
    message: {
        apikey: 'YOUR_API_KEY',
    }
)

response.body