---
title: "Get earnings calendar events"
method: GET
path: "/v1/calendar/earnings"
tags: ["Earnings calendar"]
---

# Get earnings calendar events

`GET /v1/calendar/earnings`

Returns earnings calendar data powered by Benzinga, including scheduled earnings dates, EPS and revenue estimates, reported actuals, and surprise metrics. Filter by tickers, date range, or importance level.

## Query parameters

- `apiKey` string — API Key (alternatively send via X-Api-Key header)
- `tickers` string — Comma-separated company keys (EXCHANGE_TICKER format, e.g. NASDAQ_AAPL,NYSE_MSFT) or plain ticker symbols (AAPL,MSFT). Max 50.
- `date` string — Single date to query (YYYY-MM-DD). Shorthand for dateFrom and dateTo when both are the same.
- `dateFrom` string — Start date for date range filter (YYYY-MM-DD)
- `dateTo` string — End date for date range filter (YYYY-MM-DD)
- `importance` number — Minimum importance level to filter by (0-5). Returns events with importance greater than or equal to this value.
- `page` number — Page offset for pagination (0-100000)
- `pageSize` number — Number of results per page (max 1000)
- `isin` string — ISIN to look up. Resolves to ticker via our database, then queries Benzinga.
- `cusip` string — CUSIP to look up. Resolves to ticker via our database, then queries Benzinga.
- `dateSort` string — Sort by date. Use date:asc or date:desc
- `updated` number — Only return records updated after this Unix timestamp (UTC)

## Response `200`

Earnings calendar events

- object[]
  - `id` string, required
  - `date` string, required
  - `dateConfirmed` string
  - `time` string
  - `ticker` string, required
  - `exchange` string, required
  - `name` string, required
  - `isin` string
  - `cusip` string
  - `currency` string
  - `period` string
  - `periodYear` number
  - `epsType` string
  - `eps` number
  - `epsEst` number
  - `epsPrior` number
  - `epsSurprise` number
  - `epsSurprisePercent` number
  - `revenueType` string
  - `revenue` number
  - `revenueEst` number
  - `revenuePrior` number
  - `revenueSurprise` number
  - `revenueSurprisePercent` number
  - `importance` number
  - `notes` string
  - `updated` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/fiscal/apis/openapi.md) · [All operations](https://skmtc.dev/fiscal/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fiscal/openapi/revisions/41b4b03cdc21/schema)