Earnings Surprises

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.

POST /v1/latest-surprise/query

Earnings Surprises

cURL

curl --request POST \
  --url https://api.bigdata.com/v1/latest-surprise/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "identifier": {
    "type": "rp_entity_id",
    "value": "4A6F00"
  }
}
'

200

{
  "results": [
    {
      "rp_entity_id": "<string>",
      "target_identifier_id": "GOOGL",
      "reporting_date": "2025-07-23",
      "eps_actual": 2.31,
      "eps_estimated": 2.15,
      "revenue_actual": 96428000000,
      "revenue_estimated": 99697450760,
      "last_updated": "2025-09-16",
      "eps_surprise_pct": 7.441,
      "revenue_surprise_pct": -3.379
    }
  ],
  "errors": [
    {
      "message": "<string>"
    }
  ],
  "metadata": {
    "request_id": "<string>",
    "timestamp": "<string>"
  }
}

Authorizations

X-API-KEY · string · header · required

Body

application/json

identifier · Identifier · object · required

Object specifying which identifier you are using to request the financial latest surprise. You must supply one type and its corresponding value.

Show child attributes

Response

200 - application/json

Successful Response

results · LatestSurprise · object[] · required

Show child attributes

errors · ErrorDetail · object[] | null

Show child attributes

metadata · Metadata · object

Show child attributes