Estimates

Analyst Consensus Estimates

GET/v2/estimates/consensus

Returns consensus EPS, EBITDA, and EBIT estimates across fiscal periods.

Estimates are on the basis the covering analysts forecast, which for most companies is adjusted (non-GAAP): one-off items such as restructuring charges, impairments or tax effects are left out. EPS and net income therefore differ from the reported figures in /v2/equities/income-statement and from reported-basis series of other vendors. Tesla FY2025: consensus EPS 1.66 USD, reported 1.18 USD. SAP FY2024: consensus 4.44 EUR, reported 2.68 EUR.

Included in: Startup, Pro, Growth.

Authentication

Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key · Authentication guide

Parameters

Required: one of symbol, isin, for example symbol=AAPL.

Name	In	Type	Required	Description
symbol	query	string	one of symbol, isin	Stock ticker symbol (e.g., `AAPL`, `MSFT`, `GOOGL`). Provide exactly one of symbol or isin. Example `AAPL`
isin	query	string	one of symbol, isin	ISIN code (e.g., `US0378331005`). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

Try it

symbol query

Stock ticker symbol (e.g., `AAPL`, `MSFT`, `GOOGL`). Provide exactly one of symbol or isin.

isin query

ISIN code (e.g., `US0378331005`). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

GET /v2/estimates/consensus?symbol=AAPL

API key

Sent only to api.bavest.co for this request; not stored.

Sign in to send Get an API keySends with the key above, or sign in to use your account's key. Each request counts as one API call.

curl 'https://api.bavest.co/v2/estimates/consensus?symbol=AAPL' \
  -H "x-api-key: $BAVEST_API_KEY"

Samples read your key from BAVEST_API_KEY and follow the form.

Example response 200

{
  "data": [
    {
      "date": "2030-09-27",
      "symbol": "AAPL",
      "estimatedRevenueLow": 619792040000,
      "estimatedRevenueHigh": 698463300000,
      "estimatedRevenueAvg": 647707000000,
      "estimatedEbitdaLow": 235875650000,
      "estimatedEbitdaHigh": 272618100000,
      "estimatedEbitdaAvg": 248913020000,
      "estimatedEbitLow": 220967960000,
      "estimatedEbitHigh": 257710390000,
      "estimatedEbitAvg": 234005330000,
      "estimatedNetIncomeLow": 182786620000,
      "estimatedNetIncomeHigh": 213361690000,
      "estimatedNetIncomeAvg": 193635610000,
      "estimatedSgaExpenseLow": 39891337000,
      "estimatedSgaExpenseHigh": 44954812000,
      "estimatedSgaExpenseAvg": 41688015000,
      "estimatedEpsLow": 12.182,
      "estimatedEpsHigh": 14.2197,
      "estimatedEpsAvg": 12.905,
      "numberAnalystsEstimatedRevenue": null,
      "numberAnalystsEstimatedEps": 15,
      "currency": "USD",
      "fiscalYearEnd": "2030-09-27",
      "fiscalYear": 2030
    },
    {
      "date": "2029-09-27",
      "symbol": "AAPL",
      "estimatedRevenueLow": 591422900000,
      "estimatedRevenueHigh": 666493200000,
      "estimatedRevenueAvg": 618060100000,
      "estimatedEbitdaLow": 223721370000,
      "estimatedEbitdaHigh": 258569800000,
      "estimatedEbitdaAvg": 236086720000,
      "estimatedEbitLow": 209645360000,
      "estimatedEbitHigh": 244493800000,
      "estimatedEbitAvg": 222010700000,
      "estimatedNetIncomeLow": 173364580000,
      "estimatedNetIncomeHigh": 202363550000,
      "estimatedNetIncomeAvg": 183654330000,
      "estimatedSgaExpenseLow": 38065430000,
      "estimatedSgaExpenseHigh": 42897140000,
      "estimatedSgaExpenseAvg": 39779873000,
      "estimatedEpsLow": 11.554,
      "estimatedEpsHigh": 13.4867,
      "estimatedEpsAvg": 12.2398,
      "numberAnalystsEstimatedRevenue": null,
      "numberAnalystsEstimatedEps": 11,
      "currency": "USD",
      "fiscalYearEnd": "2029-09-27",
      "fiscalYear": 2029
    }
  ],
  "meta": {
    "parameters": {
      "symbol": "AAPL"
    },
    "time": 20
  }
}

From the docs, not your data. Long lists are cut to 3 items.

Response 200

Successful response · application/json

dataarray of EstimatePeriod
- datestring (date)
  Fiscal period end date. Same value as fiscalYearEnd; kept for existing clients. Do not read the year of this date as the fiscal year, use fiscalYear.
  Example 2026-09-27
- fiscalYearEndstring (date)
  Last day of the fiscal year the estimates cover.
  Example 2027-01-25
- fiscalYearinteger
  Fiscal year label as FactSet prints it. A fiscal year ending in January, or in the first seven days of February (52/53-week years), carries the year it started in: NVIDIA's year ending 2027-01-25 is 2026. Every other fiscal year carries the year it ends in (Toyota's year ending 2026-03-31 is 2026).
  Example 2026
- currencystring | null
  ISO 4217 currency of all monetary values and EPS in this row: the company's reporting currency, also on foreign listings (Toyota in JPY on Xetra and NYSE, ASML in EUR on NASDAQ). Null when no annual report is on file.
  Example USD
- symbolstring
  Ticker symbol of the company.
  Example AAPL
- estimatedEbitAvgnumber (double) | null
  Consensus average EBIT estimate.
  Example 194822900000
- estimatedEbitHighnumber (double) | null
  Highest EBIT estimate among analysts.
  Example 205228900000
- estimatedEbitLownumber (double) | null
  Lowest EBIT estimate among analysts.
  Example 187009450000
- estimatedEbitdaAvgnumber (double) | null
  Consensus average EBITDA estimate.
  Example 209951540000
- estimatedEbitdaHighnumber (double) | null
  Highest EBITDA estimate among analysts.
  Example 221165600000
- estimatedEbitdaLownumber (double) | null
  Lowest EBITDA estimate among analysts.
  Example 201531340000
- estimatedEpsAvgnumber (double) | null
  Consensus average EPS estimate.
  Example 13.33
- estimatedEpsHighnumber (double) | null
  Highest EPS estimate among analysts.
  Example 14.2556
- estimatedEpsLownumber (double) | null
  Lowest EPS estimate among analysts.
  Example 12.635
- estimatedNetIncomeAvgnumber (double) | null
  Consensus average net income estimate.
  Example 200012610000
- estimatedNetIncomeHighnumber (double) | null
  Highest net income estimate among analysts.
  Example 213900800000
- estimatedNetIncomeLownumber (double) | null
  Lowest net income estimate among analysts.
  Example 189584490000
- estimatedRevenueAvgnumber (double) | null
  Consensus average revenue estimate.
  Example 581688000000
- estimatedRevenueHighnumber (double) | null
  Highest revenue estimate among analysts.
  Example 612757500000
- estimatedRevenueLownumber (double) | null
  Lowest revenue estimate among analysts.
  Example 558359200000
- estimatedSgaExpenseAvgnumber (double) | null
  Consensus average SGA expense estimate.
  Example 37438870000
- estimatedSgaExpenseHighnumber (double) | null
  Highest SGA expense estimate among analysts.
  Example 39438578000
- estimatedSgaExpenseLownumber (double) | null
  Lowest SGA expense estimate among analysts.
  Example 35937370000
- numberAnalystsEstimatedEpsinteger | null
  Number of analysts providing EPS estimates.
  Example 14
- numberAnalystsEstimatedRevenueinteger | null
  Number of analysts providing revenue estimates.
metaResponseMeta
Response envelope metadata. Always present on a 200: time is set by core/response.py on every successful response. Errors carry the same block, built by the same code, so a client parses one meta shape whether the call succeeded or failed.
- timeinteger
  Server-side processing time in milliseconds
  Example 17
- parametersobject
  Echo of the request parameters the endpoint resolved

Errors

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
401Missing or invalid API key.
404Resource not found.
429Rate limit exceeded. Retry after the `Retry-After` header interval.
500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.