Default

Earnings Calendar

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

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

Changed in 6 of the 35 revisions of this API.5113

Jul 27, 2021b9cd697cee6d2See the full diff
- ▲
  the // response's property type changed from integer to number, and format from int64 to float for status
  response-property-type-changed
- ▲
  the // response's property type changed from integer to number, and format from int64 to float for status
  response-property-type-changed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 26, 20210f755a71e9039See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 23, 2021a148c0b2d5831See the full diff
- ○
  api tag Default added
  api-tag-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 1, 2020e30753df924e1See the full diff
- ▲
  for the query request parameter international, the type changed from no type to boolean
  request-parameter-type-changed
Jun 11, 202026499f908d7811See the full diff
- ▲
  the response's body type changed from array to object for status
  response-body-type-changed
- ○
  added the optional property to the response with the status
  response-optional-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 26, 2020c5b8e420b78c112See the full diff
- ▲
  the response's body type changed from object to array for status
  response-body-type-changed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  api tag Default removed
  api-tag-removed
- ○
  for the query request parameter international, the type was generalized from boolean to no type
  request-parameter-type-generalized
This revision also has 146 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history