Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Earnings Calendar API

The Earnings Calendar API provides access to earnings results and upcoming earning dates for all major companies.

Available endpoints:

(4.7)

From 8,223 users

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
430ms473ms506ms644ms1146ms

Didn't find what you were looking for? Suggest an improvement

/v1/earningscalendar GET

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.

Parameters

Either ticker or date must be provided.

  • ticker  optional

    Company ticker symbol (e.g., MSFT). If provided, returns earnings data for that specific company.

  • date  optional

    Date in YYYY-MM-DD format (e.g., 2024-01-15). If provided, returns all earnings data for that specific date.

  • show_upcoming  optional premium only

    Whether to show upcoming earnings dates. Must be either true or false. If unset, the default value is false.

  • limit  optional premium only

    How many results to return. Must be between 1 and 10 (inclusive). Default is 3.

  • offset  optional premium only

    Number of results to skip for pagination. Must be a non-negative integer. Use in combination with limit to paginate through results.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

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

  • earnings_call_timestamp  premium only

    Unix timestamp of when the earnings call occurred or is scheduled to occur.

  • earnings_timing  premium only

    Timing of the earnings call. Possible values are:

    • before_market: Earnings call occurs before the market opens.

    • during_market: Earnings call occurs during regular market hours.

    • after_market: Earnings call occurs after the market closes.

Sample Request Live Demo!

ticker
date
show_upcoming premium
limit premium
offset premium

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/earningscalendar?ticker=MSFT

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
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 27 28 29 30 31 32 [ { "date": "2024-07-30", "ticker": "MSFT", "actual_eps": 2.95, "estimated_eps": 2.93, "actual_revenue": 64727000000, "estimated_revenue": 64382224966, "earnings_call_timestamp": 1722362400, "earnings_timing": "after_market" }, { "date": "2024-04-25", "ticker": "MSFT", "actual_eps": 2.94, "estimated_eps": 2.82, "actual_revenue": 61858000000, "estimated_revenue": 60861823613, "earnings_call_timestamp": 1714060800, "earnings_timing": "after_market" }, { "date": "2024-01-30", "ticker": "MSFT", "actual_eps": 2.93, "estimated_eps": 2.78, "actual_revenue": 62020000000, "estimated_revenue": 56239300000, "earnings_call_timestamp": 1706637600, "earnings_timing": "after_market" } ]

Code Examples

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.

/v1/earningscalendarlist GETPremium Only

https://api.api-ninjas.com/v1/earningscalendarlist

Returns a list of all available companies in the earnings calendar. Use it to find tickers for the /v1/earningscalendar endpoint.

Parameters

This endpoint does not require any parameters.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of objects, each containing:

  • ticker

    The company ticker symbol.

  • company

    The company name.

Sample Request

GET
https://api.api-ninjas.com/v1/earningscalendarlist

Sample Response

JSON
1 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." }, "..." ]

/v1/upcomingearnings GETPremium Only

https://api.api-ninjas.com/v1/upcomingearnings

Returns a list of upcoming earnings dates with filtering capabilities. You can filter by date range, single date, exchange, or ticker symbol. Results are limited to dates from today onwards.

Parameters

All parameters are optional. If no parameters are provided, returns upcoming earnings from today onwards (up to 100 results).

  • start_date  optional

    Start date in YYYY-MM-DD format (e.g., 2024-01-15). Must be today or later. Defaults to today if not provided.

  • end_date  optional

    End date in YYYY-MM-DD format (e.g., 2024-12-31). Must be after start_date. Defaults to 10 years from today if not provided.

  • date  optional

    Single date in YYYY-MM-DD format (e.g., 2024-01-15). If provided, overrides start_date and end_date to filter by this exact date.

  • exchange  optional

    Exchange code to filter by (e.g., NASDAQ, NYSE, HKSE, LSE, TSX). Returns only earnings from companies listed on the specified exchange.

  • ticker  optional

    Ticker symbol to filter by (e.g., AAPL, 0700.HK). Returns only earnings for that specific company.

  • limit  optional

    Maximum number of results to return. Must be between 1 and 100 (inclusive). Default is 100.

  • offset  optional

    Number of results to skip for pagination. Must be a non-negative integer. Use in combination with limit to paginate through results.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of upcoming earnings objects. Each object in the array contains:

  • ticker

    The ticker symbol of the company.

  • date

    The date of the upcoming earnings (YYYY-MM-DD format).

  • eps_estimated

    The estimated earnings per share in USD (may be null).

  • revenue_estimated

    The estimated revenue in USD (may be null).

  • exchange

    The exchange code where the company is listed (e.g., NASDAQ, NYSE, HKSE).

Sample Request Live Demo!

start_date
end_date
date
exchange
ticker
limit
offset

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/upcomingearnings?exchange=NASDAQ

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
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 27 28 29 30 31 [ { "ticker": "ARKR", "date": "2025-12-15", "eps_estimated": null, "revenue_estimated": null, "exchange": "NASDAQ" }, { "ticker": "CSBR", "date": "2025-12-15", "eps_estimated": null, "revenue_estimated": 14042000, "exchange": "NASDAQ" }, { "ticker": "HSCS", "date": "2025-12-15", "eps_estimated": -0.9, "revenue_estimated": null, "exchange": "NASDAQ" }, { "ticker": "IMMR", "date": "2025-12-15", "eps_estimated": null, "revenue_estimated": null, "exchange": "NASDAQ" }, "..." ]