---
title: "Upcoming earnings"
method: GET
path: "/api/earnings/upcoming"
tags: ["Earnings"]
---

# Upcoming earnings

`GET /api/earnings/upcoming`

![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

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.

## Query parameters

- `days` integer
- `page` integer
- `pageSize` integer

## Response `200`

Paginated list of upcoming earnings.

- object
  - `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` object[]
    - `symbols` 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` '10-Q' | '10-K' — Filing type for the upcoming report.
    - `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` 'pre_market' | 'after_hours' — Expected time of day for the report. Absent when not supplied.

## Other responses

- `400` — Invalid parameters
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)