---
title: "Earnings Calendar (Date Range)"
method: GET
path: "/api/v1/earnings/calendar"
tags: ["Earnings"]
---

# Earnings Calendar (Date Range)

`GET /api/v1/earnings/calendar`

## Request

- Base URL: `https://earningscalls.dev`
- URL: `https://earningscalls.dev/api/v1/earnings/calendar`
- Auth: API key in header `X-API-Key`

Bulk earnings calendar over an arbitrary date range (max 92 days per request), paginated up to 500 rows per page. Supports multi-symbol and multi-issuer filters and `updated_since` for cheap delta syncs. Placeholder clock times are served as `event_time: null` plus a `session` hint (before_open / after_close / unknown) — never as a fake timestamp. Rows resolve to an issuer by symbol only when that mapping is unambiguous, and carry `call_id` once a matching earnings call exists in the archive. Calendar rows carry no venue identity (mic/exchange/country are not available on this endpoint).

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required
- `page` integer
- `limit` integer
- `symbols` string
- `issuer_ids` string
- `updated_since` string

## Response `200`

Default Response

---

[API](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api.md) · [All operations](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/revisions/00131591f434?raw)