The Earnings Calendar API provides access to earnings results and upcoming earning dates for all major companies.
https://api.api-ninjas.com/v1/earningscalendar
Returns a list of past earnings results and upcoming earnings dates. You can query by ticker symbol to get earnings for a specific company, or by date to get all earnings for a specific date. Returns 3 earnings results unless the limit
parameter is set.
Either ticker
or date
must be provided.
ticker
optionalCompany ticker symbol (e.g., MSFT
). If provided, returns earnings data for that specific company.
date
optionalDate in YYYY-MM-DD format (e.g., 2024-01-15
). If provided, returns all earnings data for that specific date.
show_upcoming
optionalWhether to show upcoming earnings dates. Must be either true
or false
. If unset, the default value is false
.
limit
optional Premium OnlyHow many results to return. Must be between 1
and 100
(inclusive).
X-Api-Key
requiredAPI Key associated with your account.
date
The date of the earnings.
ticker
The ticker symbol of the company.
actual_eps
The actual earnings per share in USD.
estimated_eps
The estimated earnings per share in USD.
actual_revenue
The actual revenue in USD.
estimated_revenue
The estimated revenue in USD.
https://api.api-ninjas.com/v1/earningscalendar?ticker=MSFT
Headers
X-Api-Key
Log in or sign up to get your API Key
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[
{
"date": "2024-07-30",
"ticker": "MSFT",
"actual_eps": 2.95,
"estimated_eps": 2.93,
"actual_revenue": 64727000000,
"estimated_revenue": 64382224966
},
{
"date": "2024-04-25",
"ticker": "MSFT",
"actual_eps": 2.94,
"estimated_eps": 2.82,
"actual_revenue": 61858000000,
"estimated_revenue": 60861823613
},
{
"date": "2024-01-30",
"ticker": "MSFT",
"actual_eps": 2.93,
"estimated_eps": 2.78,
"actual_revenue": 62020000000,
"estimated_revenue": 56239300000
}
]
1
2
curl -X GET "https://api.api-ninjas.com/v1/earningscalendar?date=2024-01-15" \
-H "X-Api-Key: YOUR_API_KEY"
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.