The Earnings Calendar API provides access to earnings results and upcoming earning dates for all major companies. For a list of all available companies in the earnings calendar, see the /v1/earningscalendarlist endpoint.
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.
dateThe date of the earnings.
tickerThe ticker symbol of the company.
actual_epsThe actual earnings per share in USD.
estimated_epsThe estimated earnings per share in USD.
actual_revenueThe actual revenue in USD.
estimated_revenueThe estimated revenue in USD.
https://api.api-ninjas.com/v1/earningscalendar?ticker=MSFTHeaders
X-Api-KeyLog in or sign up to get your API Key1
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.
https://api.api-ninjas.com/v1/earningscalendarlist
Returns a list of all available companies in the earnings calendar.
This endpoint does not require any parameters.
X-Api-Key requiredAPI Key associated with your account.
Returns an array of objects, each containing:
tickerThe company ticker symbol.
companyThe company name.
https://api.api-ninjas.com/v1/earningscalendarlist1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[
{
"ticker": "MSFT",
"company": "Microsoft Corporation"
},
{
"ticker": "AAPL",
"company": "Apple Inc."
},
{
"ticker": "GOOG",
"company": "Alphabet Inc."
},
{
"ticker": "AMZN",
"company": "Amazon.com Inc."
},
{
"ticker": "TSLA",
"company": "Tesla Inc."
},
"..."
]