Upcoming earnings

GET/api/earnings/upcoming

Returns companies expected to report earnings in the next N days (default 7, max 14), sorted by earnings date ascending. Dates are predicted from historical SEC filing patterns and may differ from actual announcements. 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 14 · default 7

Look-ahead window in days. Capped at 14 to keep predictions accurate.

Example: 7
page integer optional min 1 · default 1

Page number (1-indexed).

Example: 1
pageSize integer optional min 1 · max 100 · 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:
- symbol string
  Deprecated: the primary-marked ticker, kept for backwards compatibility. Use `symbols` instead, which lists every active ticker.
- name string
  Company name.
- symbols array of string
  All active tickers for the company, primary first. Positionally aligned with `exchanges` (symbols[i] trades on exchanges[i]).
- exchanges array of string
  Exchange for each ticker in `symbols`, in the same order. Not deduplicated.
- earningsDate string
  Predicted earnings call date (YYYY-MM-DD).
- filingDate string
  Predicted SEC filing availability date (YYYY-MM-DD).
- filingType string (enum)
  Expected filing type for the upcoming report.
  Allowed values: 10-Q, 10-K

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 3,
  "totalResults": 142,
  "data": [
    {
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "symbols": [
        "SKIL",
        "SKILW"
      ],
      "exchanges": [
        "NYSE",
        "OTC"
      ],
      "earningsDate": "2026-05-01",
      "filingDate": "2026-05-08",
      "filingType": "10-Q"
    }
  ]
}

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

{}