Documentation - Earnings Calendar

Data Freshness

Authentication

Confirmed Earnings

Projected Earnings

Upcoming Earnings

Dividend Events

Calendar subscription

Data Freshness

Events taking place in the next 90 days (forecasts) are refreshed multiple times per day.
Projected events tend to get more accurate (larger weight score) a couple weeks before the actual event.
Confirmed Earnings dates are confirmed per press release. In case of a date change, a new press release will be published.

Authentication

All API calls requires authentication with an API key which can be passed either as an URL query parameter ?api_key=$KEY or as an HTTP header X-Api-Key: $KEY

Fair Use

The REST API is rate limited to 1 request per second per API key.

Confirmed Earnings

dataset cardinality and coverage

GET https://api.earningscalendar.net/confirmed_earnings

Description

Get confirmed earnings events by iso date, by year, or by ticker. Data is available from the beginning of 2020 and include future earnings events.

Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

An array of objects, each representing a confirmed earnings event.

date ISO date of this earnings event.
ticker Ticker as traded on the exchange.
url URL to the press release that confirmed this event.
title Title of the press release that confirmed this event.
security_name Name of the security trading under this symbol/ticker.
exchange The exchange where the security is trading. One of AMEX, NASDAQ, NYSE.
when When are earnings slated to be released that day. Returned only if known, otherwise the string "null".
pub_date Publication date of the press release that confirmed this event

[
  {
    "ticker": "NOV",
    "when": "postmarket",
    "date": "2020-07-27",
    "title": "National Oilwell Varco Announces Second Quarter 2020 Earnings Conference Call",
    "url": "https://www.businesswire.com/news/home/20200521005785/en",
    "pub_date": "2020-05-21T22:04:00",
    "security_name": "National Oilwell Varco, Inc. Common Stock",
    "exchange": "NYSE"
  },
  {
    "ticker": "WSM",
    "when": "postmarket",
    "date": "2020-05-28",
    "title": "Williams-Sonoma, Inc. announces release date for first quarter 2020 results: Thursday, May 28, 2020",
    "url": "https://www.businesswire.com/news/home/20200521005578/en",
    "pub_date": "2020-05-21T21:00:00",
    "security_name": "Williams-Sonoma, Inc. Common Stock (DE)",
    "exchange": "NYSE"
  },
...

Queries

Get today's events

curl "https://api.earningscalendar.net/confirmed_earnings?api_key=$KEY"

Get last 25 published releases

curl "https://api.earningscalendar.net/confirmed_earnings?latest=true&api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/confirmed_earnings?ticker=f&api_key=$KEY"

Get by date range (max 30 days)

curl "https://api.earningscalendar.net/confirmed_earnings?from_date=2020-02-05&to_date=2020-02-10&api_key=$KEY"

Get by date range (max 10 days), or date range and tickers (max 31 days, max 100 tickers)

curl "https://api.earningscalendar.net/confirmed_earnings?from_date=2020-02-05&to_date=2020-02-10&tickers=A,B,C&api_key=$KEY"

Get by earnings date

curl "https://api.earningscalendar.net/confirmed_earnings?date=2020-02-05&api_key=$KEY"

Get by year

curl "https://api.earningscalendar.net/confirmed_earnings?year=2020&api_key=$KEY"

Projected Earnings

dataset cardinality and coverage

GET https://api.earningscalendar.net/earnings

Description

Get earnings events by iso date, by year, or by ticker. Data is available from 2010-01-01 and include future earnings events.

Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

An array of objects, each representing an earnings event.

date ISO date of this earnings event.
ticker Ticker as traded on the exchange.
weight Proprietary signal reflecting accuracy of the earnings events. The bigger the more accurate.
security_name Name of the security trading under this symbol/ticker.
exchange The exchange where the security is trading. One of AMEX, NASDAQ, NYSE.
when When are earnings slated to be released that day. Returned only if known, otherwise the string "null".
updated_at When this announcement date was last checked for accuracy. In ISO date time format.

[
  {
    "ticker":"TWTR",
    "when":"premarket",
    "weight":5,
    "date":"2019-02-07",
    "security_name":"Twitter, Inc. Common Stock",
    "exchange":"NYSE",
    "updated_at":"2020-01-30T03:07:42"
},
  {
    "ticker":"TWTR",
    "when":"premarket",
    "weight":5,
    "date":"2019-04-23",
    "security_name":"Twitter, Inc. Common Stock",
    "exchange":"NYSE",
    "updated_at":"2020-01-30T03:12:56"
},
...

Queries

Get today's events

curl "https://api.earningscalendar.net/earnings?api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/earnings?ticker=twtr&api_key=$KEY"

Get by earnings date

curl "https://api.earningscalendar.net/earnings?date=2019-10-24&api_key=$KEY"

Get by date range (max 30 days)

curl "https://api.earningscalendar.net/earnings?from_date=2019-10-24&to_date=2019-10-30&api_key=$KEY"

Get by date range (max 10 days), or date range and tickers (max 31 days, max 100 tickers)

curl "https://api.earningscalendar.net/earnings?from_date=2019-10-24&to_date=2019-10-30&tickers=A,B,C&api_key=$KEY"

Upcoming Earnings

GET https://api.earningscalendar.net/upcoming

Description

Returns all earnings events happening in the next 90 days, starting today. This synthetic endpoint conveniently combines the confirmed and projected earnings dataset in a single API call (confirmed earnings are selected first).

Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Projected Dividend Events

dataset cardinality and coverage

GET https://api.earningscalendar.net/dividends

Description

Get dividends dates by iso ex date, by year, or by ticker. Data is available from 2010-01-01 and include future dividend events.

Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

An array of objects, each representing a dividend event.

ex_date ISO formatted ex-date of this dividends event.
record_date ISO formatted record date of this dividends event.
declare_date ISO formatted declaration date of this dividends event.
amount Dividend amount.
ticker Ticker as traded on the exchange.
security_name Name of the security trading under this symbol/ticker.
exchange The exchange where the security is trading. One of AMEX, NASDAQ, NYSE.
updated_at When this announcement date was last checked for accuracy. In ISO date time format.

[
  {
    "ticker":"AAPL",
    "ex_date":"2019-02-08",
    "record_date":"2019-02-11",
    "amount":0.73,
    "declare_date":"2019-01-29",
    "security_name":"Apple Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T02:08:34"
},
  {
    "ticker":"AAPL",
    "ex_date":"2019-05-10",
    "record_date":"2019-05-13",
    "amount":0.77,
    "declare_date":"2019-05-01",
    "security_name":"Apple Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T02:15:03"
},
...

Queries

Get today's events

curl "https://api.earningscalendar.net/dividends?api_key=$KEY"

Get by ex date

curl "https://api.earningscalendar.net/dividends?ex_date=2020-02-07&api_key=$KEY"

Get by ex date range (max 10 days), or ex date range and tickers (max 31 days, max 100 tickers)

curl "https://api.earningscalendar.net/dividends?from_ex_date=2020-02-05&to_ex_date=2020-03-05&tickers=a,b,c&api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/dividends?ticker=aapl&api_key=$KEY"

Get by year

curl "https://api.earningscalendar.net/dividends?year=2020-02-07&api_key=$KEY"

Calendar Feed Subscription

Our calendar subscriptions are compatible with the majority of calendar software, including Apple Calendar , Microsoft Outlook and Google Calendar

Currently only the forward earnings dataset is available as a calendar subscription. Only a snippet is available in the calendar event body due to size limits. Each calendar earning event has a direct link to a CSV file containing the entire set of earnings happening that day.