GateData.AI

Earnings results

Compare reported earnings with estimates.

GET/api/v1/earnings/results
Domain
Estimates & Earnings
Level
Public-company entity
MCP tool
estimates_earnings_query (task=results)

Available data

Returns
Reported earnings with estimates
Market coverage
US equities
Query granularity
One company per query; a fiscal-period filter narrows the result to one reporting period

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company and event positioning

Provide at least one company or event positioning field.

querystringqueryExampleAAPLconditional

Search text used to resolve the query object

entity_idstringqueryExampleentity_sec_cik_0000320193conditional

Canonical entity identifier

asset_idstringqueryExampleasset_aapl_common_stockconditional

Canonical asset identifier

instrument_idstringqueryExampleinstrument_aapl_common_stockconditional

Canonical financial instrument identifier

listing_idstringqueryExamplelisting_aapl_xnasconditional

Canonical listing identifier

earnings_event_idstringqueryExample50d368d9fa2ec6530106a9217a74874fc1690a8c5c96b546ecf68945b94369daconditional

Canonical earnings event identifier

Query filters

All optional.

marketMarketqueryExampleus_equityoptional

Market of the query object

asset_classenumqueryExampleequityoptional

Asset class of the queried object.

venue_idstringqueryExamplevenue_xnasoptional

Trading venue identifier.

windowenumqueryExamplelatestoptional

Preset query time range

fromdatequeryExample2026-07-01optional

Start date of a custom query range

todatequeryExample2026-10-31optional

End date of a custom query range

fiscal_periodstringqueryExampleFY2025Q4optional

Company fiscal-period identifier

period_typeenumqueryExamplequarterlyoptional

Financial reporting period type

allow_stalebooleanqueryExamplefalseoptional

Whether stale data may be returned

limitintegerqueryExample20optional

Maximum records returned per request

Response

dataobject

Earnings results data

results[]object[]

Earnings results

earnings_event_idstringExample0eacaaceb0500c7e5f41091a3fcccd3ed67acd53…

Canonical earnings event identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

fiscal_periodstringExampleFY2025Q4

Company fiscal-period identifier

result_statusstringExamplereported

Earnings result status

eps_actualnumberExample1.85

Reported earnings per share

eps_estimatenumberExample1.7699

Consensus earnings-per-share estimate

eps_surprisenumberExample0.08010000000000006

Difference between reported and estimated EPS

eps_surprise_pctnumberExample0.04525679416916213

Earnings-per-share surprise percentage

eps_basisstringExamplebasic

Earnings-per-share calculation basis

revenue_actualnumberExample102466003000

Reported revenue

revenue_estimatenumberExample102250480000

Consensus revenue estimate

revenue_surprisenumberExample215523000

Difference between reported and estimated revenue

revenue_surprise_pctnumberExample0.002107794506196939

Revenue surprise percentage

currencystringExampleUSD

Currency code used by the financial values

estimate_as_ofdatetimeExample2026-08-17T06:39:15.000+0000

Consensus estimate snapshot cutoff time

comparison_statusstringExamplecomparable

Comparability status of actual and estimated values

calculation_refs[]object[]

Calculation references for derived fields

fieldstringExampleeps_surprise_pct

Derived field path

formula_versionstringExamplesurprise_pct_v1

Calculation formula version

inputs[]string[]Exampleeps_actual

Input fields used by the derived value

data_statusDataStatusExampleok

Availability of this business record

data_statusDataStatusExampleok

Availability of the business data

empty_reasonstring | null

Reason code for missing data or fields

errorobject | null

Structured error information

external_refs[]object[]

Public external evidence references

citation_urlstringExamplehttps://www.sec.gov/cgi-bin/browse-edgar…

External evidence URL

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

external_ref_idstringExample0000320193

Object identifier in the external system

external_ref_typestringExampleedgar_company_filings

External reference type

external_source_domainstringExamplesec.gov

Domain of the external evidence source

lineage_refs[]object[]

Data-processing lineage references

sourcestringExampleestimates

Stable source role (e.g. estimates, calendar, results, consensus)

stagestringExamplecurrent

current or history

data_statusDataStatusExampleok

Data status at this lineage hop

source_refs[]object[]

Upstream data-source references

request_idstringExample2136e73f-57b2-488a-9386-c628440ad45a

Trace id for this request

metadataobject

Response status and resolution information

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleentity

Object reference type

idstringExampleentity_sec_cik_0000320193

Canonical object identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

resolved_fromstringExampleearnings_subject

Input used to resolve the object

resolution_confidencestring

Object resolution confidence

actual_taskstringExampleresults

Task that was actually executed

route_reasonstringExampleobject_resolver

Reason the task or object was selected

limitations[]string[]Examplesource_refs_unavailable

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:23Z

Most recent object or response update time

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.