Sign in

v1

latestOpenAPI 3.0.02026-07-266091181.5 KB
earnings

Returns the earnings data

Returns earnings data for a selected period and/or security. Includes actual EPS and revenue figures, estimates, surprises, and historical comparisons. Earnings data is crucial for investors to assess company performance.

get/api/v2.1/calendar/earnings

Query parameters

pageinteger

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date

pagesizeinteger

Number of results returned. Limit 1000

parameters[date]string YYYY-MM-DD

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from]string YYYY-MM-DD

Date to query from point in time

parameters[date_to]string YYYY-MM-DD

Date to query to point in time

parameters[date_sort]'date'

Field sort option for earnings calendar. Apply :desc, :asc for sort order

parameters[importance]0 | 1 | 2 | 3 | 4 | 5

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

parameters[tickers]string csv

One or more ticker symbols separated by a comma. Maximum 50 tickers

parameters[updated]integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

Headers

accept'application/json' required

Specifies return format. Query parameters work the same for both formats

Response

success

Example response

{
  "earnings": [
    {
      "currency": "USD",
      "date": "2024-01-09",
      "date_confirmed": 1,
      "eps": "2.18",
      "eps_est": "2.10",
      "eps_prior": "1.88",
      "eps_surprise": "0.08",
      "eps_surprise_percent": "3.81",
      "eps_type": "GAAP",
      "exchange": "NASDAQ",
      "id": "60a7f5e8e4b0f5a3c8e9f5a3",
      "importance": 5,
      "isin": "US0378331005",
      "name": "Apple Inc.",
      "notes": "Beat on EPS and revenue",
      "period": "Q1",
      "period_year": 2024,
      "revenue": "89537000000",
      "revenue_est": "88500000000",
      "revenue_prior": "81800000000",
      "revenue_surprise": "1037000000",
      "revenue_surprise_percent": "1.17",
      "revenue_type": "GAAP",
      "ticker": "AAPL",
      "time": "amc",
      "updated": 1704819600
    }
  ]
}