GateData.AI

Earnings calendar

Query the earnings event calendar.

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

Available data

Returns
The earnings event calendar
Market coverage
US equities
Query granularity
One company per query; each event belongs to that company and one fiscal 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.

windowenumqueryExamplenext_90doptional

Preset query time range

fromdatequeryExample2026-07-01optional

Start date of a custom query range

todatequeryExample2026-10-31optional

End date of a custom query range

allow_stalebooleanqueryExamplefalseoptional

Whether stale data may be returned

limitintegerqueryExample20optional

Maximum records returned per request

Response

dataobject

Earnings calendar data

events[]object[]

Earnings events

earnings_event_idstringExample50d368d9fa2ec6530106a9217a74874fc1690a8c…

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

report_datedatetimeExample2026-10-29T00:00:00.000+0000

Expected or actual earnings release date

date_confirmedbooleanExamplefalse

Whether the release date is confirmed

date_precisionEarningsDatePrecisionExampleday

Release-time precision

report_time_typeEarningsReportTimeTypeExampleunknown

Earnings release session type

timezonestringExampleAmerica/New_York

Time zone used to interpret the date

fiscal_periodstringExampleFY2026Q4

Company fiscal-period identifier

period_typeEarningsPeriodTypeExamplequarterly

Financial reporting period type

event_statusstringExamplescheduled

Current earnings event status

data_statusDataStatusExampleok

Availability of this earnings event

empty_reasonstring | null

Reason code when this record is empty

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_idstringExample8e83ca66-94e5-4317-945f-0cbd2ad499f7

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_taskstringExamplecalendar

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.