---
title: "Market-wide upcoming earnings calendar"
method: GET
path: "/calendar/earnings"
tags: ["Calendar"]
---

# Market-wide upcoming earnings calendar

`GET /calendar/earnings`

## Request

- Base URL: `https://api.signal8.ai/api/v1/public`
- URL: `https://api.signal8.ai/api/v1/public/calendar/earnings`
- Auth: API key in header `X-Api-Key`

Forward-looking earnings calendar across the tracked ticker universe,
sorted ascending by event date. Paginated.

**Credit cost: 3**

## Query parameters

- `from` string
- `to` string
- `limit` integer
- `offset` integer

## Response `200`

Earnings events

- object

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `402`: Not enough credits for this request
- `429`: Rate limit exceeded
- `503`: Calendar service not configured

---

[API](https://skmtc.dev/signal8/apis/signal8-public-api.md) · [All operations](https://skmtc.dev/signal8/apis/signal8-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signal8/apis/signal8-public-api/revisions/5a18ae8d6d58?raw)