FIfiscal
Estimates

Get Agentic Consensus estimates for a company

Changed on

Returns our forward estimates for a company's quarters and fiscal years, in its reporting currency. data opens with recently reported periods, each holding our pre-print estimate and the filed actual. Each cell has the estimate (mean), its high/low range, its source (company guidance, our model or our AI estimate) and flags. eps_gaap, net_income, ebit and ebitda carry the GAAP figure; eps_adjusted, net_income_adjusted, ebit_adjusted and ebitda_adjusted the company-adjusted one. The Agentic Consensus Reference (https://docs.fiscal.ai/docs/reference/estimates) explains periods, lines and flags. Keys without Agentic Consensus access get the free-plan companies.

get/v1/company/estimates

Request

  • Base URL
    https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.fiscal.ai/v1/company/estimates
  • Auth
    API key in query parameter apiKey

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT
micCodestring

Company MIC, use with ticker

Example:XNAS
exchangestring

Company exchange code, use with ticker

Example:NASDAQ
companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT
cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104
isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045
figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459
cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019
fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597
currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.

Example:CAD
includeReportedPeriodsboolean

Include recently reported periods (our pre-print estimate and the filed actual). Default true.

Response

Estimates for the company

companyKeystring required
companyFiscalIdentifierstring nullable required

The company's stable Fiscal.ai identifier; null for a company not yet minted one.

fiscalYearEndMonthnumber required
currencystring required

The currency of every amount and per-share figure: the reporting currency, or currency when given.

originalCurrencystring

Only with currency: the reporting currency the estimates were converted from.

updatedAtstring required
engineVersionstring required

The deploy that produced the payload.

primaryEpsBasis'gaap' | 'adjusted' required

Which EPS line leads for the company: adjusted (eps_adjusted) or gaap (eps_gaap).

Example response

{
  "companyKey": "NASDAQ_MSFT",
  "companyFiscalIdentifier": "FSCLC6CGT4DXS597",
  "fiscalYearEndMonth": 6,
  "currency": "USD",
  "originalCurrency": "GBP",
  "updatedAt": "2026-04-29T12:00:00Z",
  "engineVersion": "1a2b3c4d-...",
  "primaryEpsBasis": "adjusted",
  "data": [
    {
      "periodId": "3_Quarterly_2026-03-31",
      "periodType": "Quarterly",
      "reportDate": "2026-03-31",
      "periodDuration": "3 Months",
      "calendarYear": 2026,
      "calendarQuarter": 1,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "earningsDate": null,
      "earningsTimeOfDay": null,
      "metricsValues": {}
    }
  ]
}

Changes

  • 98f418058f97Revision changes
    • warning

      added the new triggered_one_off_left_out enum value to the ///// response property for the response status

  • 0413ba5b5bfdRevision changes
    • warning

      added the new guidance_calculated enum value to the //// response property for the response status

    • warning

      added the new split_from_half enum value to the ///// response property for the response status