---
title: "Who reports earnings this week, next week or the week after, grouped by day"
method: GET
path: "/earnings"
tags: ["earnings"]
---

# Who reports earnings this week, next week or the week after, grouped by day

`GET /earnings`

## Request

- Base URL: `https://api.rapidtradeview.trade`
- URL: `https://api.rapidtradeview.trade/earnings`
- Auth: none declared

Every report row says whether its date is confirmed. For companies in the stocks RapidTradeView covers with a market cap of $10B or more, date_confirmed is true only when Yahoo Finance shows the company's confirmed date for that day (a listed session alone does not confirm it); a company not checked (at most 60 per week, largest first) stays false. For every other row, date_confirmed is true when the row names a session (hour bmo, amc or dmh). false means the date is the calendar's listing, not confirmed as the company's announced date. date_confirmed_source is calendar (the calendar's date) or company (the row was moved to the company's confirmed date; hour is Yahoo's, filled only when the release time is clearly before the open or after the close, never the calendar's session for the old day). A company is listed once: a moved row leaves its old day and that day's count. moved_out counts companies whose confirmed date falls outside the week; they stay listed on the calendar's date with date_confirmed false.

## Query parameters

- `weeks_ahead` integer
- `scope` 'universe' | 'all'

## Response `200`

The week, grouped by day

- EarningsWeek
  - `week_start` string, date
  - `week_end` string, date
  - `count` integer: Reports in the week, each company once
  - `truncated` boolean
  - `moved_out` integer: Companies whose confirmed date falls outside this week; they stay listed here on the calendar's date with date_confirmed false.
  - `scope` string: all, for scope=all
  - `source` string
  - `days` object[]
    - `date` string, date
    - `count` integer: scope=all: the day's true count
    - `truncated` boolean
    - `reports` EarningsCalendarRow[]
      - `symbol` string, required
      - `date` string, date, required
      - `hour` 'bmo' | 'amc' | 'dmh' | 'null', nullable, required: Before the open, after the close, during market hours; null when not given
      - `date_confirmed` boolean, required: Large covered companies ($10B+): true only when Yahoo Finance shows the company's confirmed date. Other rows: true when a session is given. false: the calendar's listing, not confirmed as the company's date
      - `date_confirmed_source` 'calendar' | 'company', required: calendar: the calendar's date. company: moved to the company's confirmed date
      - `quarter` integer, nullable
      - `year` integer, nullable
      - `eps_estimate` number, nullable
      - `eps_actual` number, nullable
      - `revenue_estimate` number, nullable
      - `revenue_actual` number, nullable
      - `in_universe` boolean: scope=all only
      - `market_cap` number, nullable: scope=all only; covered stocks

## Other responses

- `422`: Bad parameter
- `503`: Temporarily unavailable; try again later

---

[API](https://skmtc.dev/rapidtradeview/apis/rapidtradeview-api.md) · [All operations](https://skmtc.dev/rapidtradeview/apis/rapidtradeview-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rapidtradeview/apis/rapidtradeview-api/revisions/571481af40d4?raw)