Default

Earnings Calendar

Changed on

Get historical and coming earnings release. EPS and Revenue in this endpoint are non-GAAP, which means they are adjusted to exclude some one-time or unusual items. This is the same data investors usually react to and talked about on the media. Estimates are sourced from both sell-side and buy-side analysts.

get/calendar/earnings

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/calendar/earnings
  • Auth
    API key in query parameter token

Query parameters

fromstring date

From date: 2020-03-15.

tostring date

To date: 2020-03-16.

symbolstring

Filter by symbol: AAPL.

internationalboolean

Set to <code>true</code> to include international markets. Default value is <code>false</code>

Response

successful operation

Example response

{
  "earningsCalendar": [
    {
      "date": "2000-01-23",
      "symbol": "symbol",
      "epsActual": 5.962134,
      "hour": "hour",
      "epsEstimate": 1.4658129,
      "revenueEstimate": 5.637377,
      "revenueActual": 2.302136,
      "year": 0,
      "quarter": 6
    },
    {
      "date": "2000-01-23",
      "symbol": "symbol",
      "epsActual": 5.962134,
      "hour": "hour",
      "epsEstimate": 1.4658129,
      "revenueEstimate": 5.637377,
      "revenueActual": 2.302136,
      "year": 0,
      "quarter": 6
    }
  ]
}

Changes

  • b9cd697cee6dRevision changes
    • breaking

      the // response's property type changed from integer to number, and format from int64 to float for status

    • breaking

      the // response's property type changed from integer to number, and format from int64 to float for status

  • 0f755a71e903Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status