---
title: "Earnings Surprises"
method: POST
path: "/v1/latest-surprise/query"
tags: ["Analyst Estimates"]
---

# Earnings Surprises

`POST /v1/latest-surprise/query`

The Earnings Surprises API allows users to retrieve the most recent quarterly
earnings surprise data for a specific company. This endpoint provides actual versus
estimated earnings per share (EPS) and revenue (sales), highlighting whether the
company has beaten, missed, or met expectations.

## Request body

- LatestSurpriseQuery
  - `identifier` Identifier, required
    - `type` 'rp_entity_id', required
    - `value` union, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
      - string
      - string[]

## Response `200`

Successful Response

- LatestSurpriseResponse
  - `results` LatestSurprise[], required
    - `rp_entity_id` string, required — RavenPack internal entity identifier.
    - `target_identifier_id` string, nullable, required — The target identifier provided in the request, e.g., stock symbol.
    - `reporting_date` string, date-time, nullable — The end date of the fiscal period.
    - `eps_actual` number, nullable — The actual EPS of the company.
    - `eps_estimated` number, nullable — The estimated EPS of the company.
    - `revenue_actual` number, nullable — The actual revenue of the company.
    - `revenue_estimated` number, nullable — The estimated revenue of the company.
    - `last_updated` string, date-time, nullable — The last updated date of the data.
    - `eps_surprise_pct` number, nullable — The surprise percentage of the EPS.
    - `revenue_surprise_pct` number, nullable — The surprise percentage of the revenue.
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)