---
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.

---

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