---
title: "Earnings Surprises"
method: GET
path: "/stock/earnings"
tags: ["Default"]
---

# Earnings Surprises

`GET /stock/earnings`

Get company historical quarterly earnings surprise going back to 2000.

## Query parameters

- `symbol` string, required
- `limit` integer

## Response `200`

successful operation

- EarningResult[]
  - `actual` number, float — Actual earning result.
  - `estimate` number, float — Estimated earning.
  - `surprise` number, float — Surprise - The difference between actual and estimate.
  - `surprisePercent` number, float — Surprise percent.
  - `period` string, date — Reported period.
  - `symbol` string — Company symbol.
  - `year` integer — Fiscal year.
  - `quarter` integer — Fiscal quarter.

## Changes

- **2023-03-31** `fe3acff4e0d7` — 2 info
  - added the optional property `items/quarter` to the response with the `200` status
  - added the optional property `items/year` to the response with the `200` status
- **2021-07-23** `a148c0b2d583` — 3 info
  - api tag `Default` added
  - added the optional property `items/surprise` to the response with the `200` status
  - added the optional property `items/surprisePercent` to the response with the `200` status
- **2020-05-26** `c5b8e420b78c` — 4 warning, 1 info
  - removed the optional property `items/quarter` from the response with the `200` status
  - removed the optional property `items/surprise` from the response with the `200` status
  - removed the optional property `items/surprisePercent` from the response with the `200` status
  - removed the optional property `items/year` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/stock/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)