Cyber Monday Sale! Get over 30% off when you subscribe to an annual subscription plan!

Earnings Calendar API

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

Available endpoints:

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
364ms386ms410ms851ms1213ms

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