---
title: "Earnings Calendar"
method: GET
path: "/calendar/earnings"
tags: ["Default"]
---

# Earnings Calendar

`GET /calendar/earnings`

Get historical and coming earnings release. EPS and Revenue in this endpoint are non-GAAP, which means they are adjusted to exclude some one-time or unusual items. This is the same data investors usually react to and talked about on the media. Estimates are sourced from both sell-side and buy-side analysts.

## Query parameters

- `from` string, date
- `to` string, date
- `symbol` string
- `international` boolean

## Response `200`

successful operation

- EarningsCalendar
  - `earningsCalendar` EarningRelease[] — Array of earnings release.
    - `symbol` string — Symbol.
    - `date` string, date — Date.
    - `hour` string — Indicates whether the earnings is announced before market open(<code>bmo</code>), after market close(<code>amc</code>), or during market hour(<code>dmh</code>).
    - `year` integer — Earnings year.
    - `quarter` integer — Earnings quarter.
    - `epsEstimate` number, float — EPS estimate.
    - `epsActual` number, float — EPS actual.
    - `revenueEstimate` number, float — Revenue estimate including Finnhub's proprietary estimates.
    - `revenueActual` number, float — Revenue actual.

## Changes

- **2021-07-27** `b9cd697cee6d` — 2 breaking
  - the `earningsCalendar/items/revenueActual` response's property type changed from `integer` to `number`, and format from `int64` to `float` for status `200`
  - the `earningsCalendar/items/revenueEstimate` response's property type changed from `integer` to `number`, and format from `int64` to `float` for status `200`
- **2021-07-26** `0f755a71e903` — 9 info
  - added the optional property `earningsCalendar/items/date` to the response with the `200` status
  - added the optional property `earningsCalendar/items/epsActual` to the response with the `200` status
  - added the optional property `earningsCalendar/items/epsEstimate` to the response with the `200` status
  - added the optional property `earningsCalendar/items/hour` to the response with the `200` status
  - …5 more
- **2021-07-23** `a148c0b2d583` — 1 info
  - api tag `Default` added
- **2020-08-01** `e30753df924e` — 1 breaking
  - for the `query` request parameter `international`, the type changed from no type to `boolean`
- **2020-06-11** `26499f908d78` — 1 breaking, 1 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the optional property `earningsCalendar` to the response with the `200` status

[Full history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/calendar/earnings/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) · [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finnhub-stock-api/finnhub-api/revisions/415b27331384/schema)