Upcoming earnings

GET/api/earnings/upcoming

Companies reporting earnings in the next N days (default 7, max 28), sorted by earnings date ascending, with consensus EPS estimates and expected report time. Companies in their first year of reporting (no prior-year earnings 8-K) are not included. Delisted companies (no active listing on any exchange) are excluded.

Get API key Try it live in the API explorer

Query parameters

days integer optional min 1 · max 28 · default 7

Look-ahead window in days (max 28).

Example: 7
page integer optional min 1 · default 1

Page number (1-indexed).

Example: 1
pageSize integer optional min 1 · max 500 · default 50

Results per page.

Example: 50

Example request

curl 'https://api.stockfit.io/v1/api/earnings/upcoming?days=7&page=1&pageSize=50' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated list of upcoming earnings.

Response schema

page integer
Current page number (1-indexed).
pageSize integer
Number of results per page.
totalPages integer
Total number of pages.
totalResults integer
Total companies reporting in the window.
data array of object
array of:
- symbols array of string
  All active tickers for the entity, primary first. A multi-class issuer like Alphabet is a single entry with both classes.
- name string
  Issuer name (SEC conformed form).
- earningsDate string
  Earnings date (YYYY-MM-DD).
- filingDate string
  Projected SEC filing availability date (YYYY-MM-DD).
- filingType string (enum)
  Filing type for the upcoming report.
  Allowed values: 10-Q, 10-K
- epsEstimate number
  Analyst consensus EPS estimate for the upcoming report. Absent when unavailable.
- numEstimates integer
  Number of analyst estimates behind epsEstimate. Absent unless epsEstimate is present.
- reportTime string (enum)
  Expected time of day for the report. Absent when not supplied.
  Allowed values: pre_market, after_hours

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 3,
  "totalResults": 142,
  "data": [
    {
      "symbols": [
        "GOOGL",
        "GOOG"
      ],
      "name": "Alphabet Inc.",
      "earningsDate": "2026-05-01",
      "filingDate": "2026-05-08",
      "filingType": "10-Q",
      "epsEstimate": 1.88,
      "numEstimates": 11,
      "reportTime": "after_hours"
    }
  ]
}

400 Bad Request

Invalid parameters

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}