Browse the docs

Earnings history

GET/v1/companies/{symbol}/earnings

A company's recent quarterly results against what analysts expected: earnings per share and revenue, each beside its estimate, newest first, so every beat and miss shows. Upcoming quarters carry estimates only.

Each call counts against your allowance.

Parameters

NameInTypeWhat it does
symbol (required)pathtickerStock ticker, like AAPL.
limitquerywhole number, 1–40How many quarters. Leave it out for 8.

Any other parameter is refused, so a typo is caught rather than quietly ignored.

Answer

The answer is { data, asOf }. Here is data, abridged: real answers carry more fields.

data (abridged)
[
  {
    "symbol": "AAPL",
    "date": "2026-07-30",
    "epsActual": 1.57,
    "epsEstimated": 1.43,
    "revenueActual": 94040000000,
    "revenueEstimated": 89350000000
  }
]

Answers and errors covers every answer’s shape and what an error carries.