getEarningsCalendar API

getEarningsCalendar

The getEarningsCalendar API provides the total number of upcoming earnings by date. And will also return the earnings data 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 for that date. And when requesting 'earnings' it will return earnings data for all symbols for the requested start date.

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 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

startDate^optional

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

Type

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

Default

2024-12-21

endDate^optional

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

Type

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

Default

2024-12-31

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)

symbol
as requested

A symbol or code that identifies a financial instrument.

string
A sequence of characters. (example: GOOG)

name
as requested

The name of the entity that the symbol or code represents.

string
A sequence of characters. (example: GOOG)

exchange
as requested

N/A

string
A sequence of characters. (example: GOOG)

timeCode
as requested

The time of day on which the earnings report is released.

string
A sequence of characters. (example: GOOG)

estimatedEarnings
as requested

The average analysts' estimate for earnings for the current quarter.

double
A numeric type defining a number with fractional parts. (example: 2.14)

lastReportedEarnings
as requested

Last reported quarterly earnings, based on GAAP income from continuing operations.

double
A numeric type defining a number with fractional parts. (example: 2.14)

lastEarningsSurpriseAmount
as requested

The difference between the estimated and reported earnings.

double
A numeric type defining a number with fractional parts. (example: 2.14)

lastEarningsSurprisePercent
as requested

The difference between the estimated and reported earnings expressed as a percent.

double
A numeric type defining a number with fractional parts. (example: 2.14)

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/getEarningsCalendar.json?apikey=YOUR_API_KEY
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getEarningsCalendar.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": "2024-12-26",
            "totalEarnings": 55
        },
        {
            "date": "2024-12-23",
            "totalEarnings": 91
        },
        {
            "date": "2024-12-27",
            "totalEarnings": 42
        },
        {
            "date": "2024-12-24",
            "totalEarnings": 88
        },
        {
            "date": "2024-12-30",
            "totalEarnings": 1
        }
    ]
}

XML

GET

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

POST

POST https://ondemand.websol.barchart.com/getEarningsCalendar.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"?>
<getEarningsCalendar>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <date>2024-12-26</date>
    <totalEarnings>55</totalEarnings>
  </item>
  <item>
    <date>2024-12-23</date>
    <totalEarnings>91</totalEarnings>
  </item>
  <item>
    <date>2024-12-27</date>
    <totalEarnings>42</totalEarnings>
  </item>
  <item>
    <date>2024-12-24</date>
    <totalEarnings>88</totalEarnings>
  </item>
  <item>
    <date>2024-12-30</date>
    <totalEarnings>1</totalEarnings>
  </item>
</getEarningsCalendar>

CSV

GET

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

POST

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

apikey=YOUR_API_KEY

Response

date,totalEarnings
"2024-12-26","55"
"2024-12-23","91"
"2024-12-27","42"
"2024-12-24","88"
"2024-12-30","1"

PHP

<?php

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

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

$result = $ondemand->getEarningsCalendar($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.getEarningsCalendar("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->getEarningsCalendar('YOUR_API_KEY');

print $result;

Python

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

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

print(result)

Ruby

require 'savon'

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

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

response.body