FIfiscal
Estimates

Get Street Consensus estimates for a company

Changed on

Returns the Wall Street analyst consensus for a company's EPS, revenue, EBITDA, EBIT, pretax income, EBITDA margin and cash flow per share, per fiscal quarter and year, from Zacks Investment Research. These are not our estimates (see /v1/company/estimates). Periods follow the company's own calendar, so periodId joins the financial statements. Reported periods are left out unless you ask for history. Keys without Street Consensus on their plan get the free-plan companies. Personal (non-commercial) API plans get none of it. Wherever the data is shown, credit it: "Data provided by Zacks Investment Research, Inc., www.zacksdata.com", linked to https://www.zacksdata.com.

get/v1/company/estimates/street

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/street
  • 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 code to convert the figures into (e.g. EUR, GBP). Case-insensitive. Defaults to USD, the currency Zacks reports in.

Example:EUR
historyboolean

Add history: every day the consensus changed in the last five calendar years (the current calendar year for keys without Street Consensus on their plan).

Response

Analyst consensus estimates for the company

companyKeystring required
companyFiscalIdentifierstring nullable required

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

currencystring nullable required

USD: Zacks reports US listings in dollars, even for companies that file in another currency. With currency, that currency.

originalCurrencystring

Only with currency: the currency Zacks reports the figures in, before conversion.

source'analyst_consensus' required

Always analyst_consensus, never our own estimate.

vendor'Zacks' required

Who aggregated the analyst estimates.

epsBasis'adjusted' | 'ffo' nullable required

What analyst_eps measures: adjusted (diluted EPS before non-recurring items; compare with eps_adjusted) or ffo (FFO per share, for an equity REIT).

updatedAtstring nullable required

Example response

{
  "companyKey": "NASDAQ_AAPL",
  "companyFiscalIdentifier": "FSCLC4VNY8NEQ478",
  "currency": "USD",
  "originalCurrency": "USD",
  "epsBasis": "adjusted",
  "updatedAt": "2026-10-05T10:30:00.000Z",
  "data": [
    {
      "periodId": "1_Quarterly_2026-09-26",
      "reportDate": "2026-09-26",
      "periodDuration": "3 Months",
      "calendarYear": 2026,
      "calendarQuarter": 3,
      "fiscalYear": 2026,
      "fiscalQuarter": 4,
      "metricsValues": {
        "analyst_eps": {
          "asOf": "2026-10-05"
        },
        "analyst_revenue": {
          "asOf": "2026-10-05"
        },
        "analyst_ebitda": {
          "asOf": "2026-10-05"
        },
        "analyst_ebit": {
          "asOf": "2026-10-05"
        },
        "analyst_pretax_income": {
          "asOf": "2026-10-05"
        },
        "analyst_ebitda_margin": {
          "asOf": "2026-10-05"
        },
        "analyst_cash_flow_per_share": {
          "asOf": "2026-10-05"
        }
      },
      "appliedExchangeRate": 0.7925
    }
  ],
  "history": [
    {
      "periodId": "1_Quarterly_2026-09-26",
      "reportDate": "2026-09-26",
      "periodDuration": "3 Months",
      "calendarYear": 2026,
      "calendarQuarter": 3,
      "fiscalYear": 2026,
      "fiscalQuarter": 4,
      "asOf": "2026-10-05",
      "appliedExchangeRate": 0.7925
    }
  ]
}

Changes

  • b71c24b008baRevision changes
    • info

      added the new optional query request parameter currency

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

  • d582fea8f51fRevision changes
    • breaking

      removed the required property from the response with the status