Save over 30% 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. For a list of all available companies in the earnings calendar, see the /v1/earningscalendarlist endpoint.

/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

    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 100 (inclusive).

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.

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 [ { "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 } ]

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