Browse the docs

Calendars

GET/v1/calendar

Upcoming events: company earnings dates with estimates, economic releases with forecasts, dividends, or IPOs.

Each call counts against your allowance.

Parameters

Name	In	Type	What it does
`kind` (required)	query	one of the values	Which calendar. One of `earnings`, `economic`, `dividends`, `ipos`.
`days_ahead`	query	whole number, 1–60	How far ahead, in days. Leave it out for `7`.
`my_watchlist_only`	query	true or false	Earnings only: just your watchlist names.

Any other parameter is refused, so a typo is caught rather than quietly ignored.

The answer is { data, asOf }. Here is data, abridged: real answers carry more fields.

data (abridged)

[
  {
    "symbol": "AAPL",
    "date": "2026-10-30",
    "epsEstimated": 1.78,
    "revenueEstimated": 102000000000,
    "time": "amc"
  }
]

Answers and errors covers every answer’s shape and what an error carries.