Docs/Reference/Earnings/Get Forecasts
GET/v1/companies/{code}/forecastsTier · Developer

Get Forecasts

Get management earnings forecasts (業績予想) for a company.

Extracted from 決算短信 XBRL: the forward guidance management provides alongside their earnings release. Only returns snapshots that contain at least one forecast field.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Query parameters · 1

Optional filters and modifiers. Pass as URL-encoded ?key=value.

yearsintegeroptional
default 5

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of EarningsForecastOut.

Envelope

dataEarningsForecastOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

EarningsForecastOut

securities_codestring | null
company_namestring | null
company_name_enstring | null
fiscal_year_endstring | null
period_typestring | null
filing_datestring | null
accounting_standardstring | null
tdnet_pdf_urlstring | null

URL of the source 決算短信 PDF on TDNet. Every forecast traces back here.

forecast_revenueinteger | null
forecast_operating_incomeinteger | null
forecast_ordinary_incomeinteger | null
forecast_net_incomeinteger | null
forecast_epsnumber | null
forecast_revenue_change_pctnumber | null
forecast_operating_income_change_pctnumber | null
forecast_net_income_change_pctnumber | null

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.