---
title: "Revenue Estimates"
method: GET
path: "/stock/revenue-estimate"
tags: ["Default"]
---

# Revenue Estimates

`GET /stock/revenue-estimate`

## Request

- Base URL: `https://finnhub.io/api/v1`
- URL: `https://finnhub.io/api/v1/stock/revenue-estimate`
- Auth: API key in query parameter `token`

Get company's revenue estimates.

## Query parameters

- `symbol` string, required
- `freq` string

## Response `200`

successful operation

- RevenueEstimates
  - `data` RevenueEstimatesInfo[]: List of estimates
    - `revenueAvg` number, float: Average revenue estimates including Finnhub's proprietary estimates.
    - `revenueHigh` number, float: Highest estimate.
    - `revenueLow` number, float: Lowest estimate.
    - `numberAnalysts` integer: Number of Analysts.
    - `period` string, date: Period.
    - `year` integer: Fiscal year.
    - `quarter` integer: Fiscal quarter.
  - `freq` string: Frequency: annual or quarterly.
  - `symbol` string: Company symbol.

## Changes

- **2023-10-17** `916ab58ae589`: 2 info
  - added the optional property `data/items/quarter` to the response with the `200` status
  - added the optional property `data/items/year` to the response with the `200` status
- **2021-07-27** `b9cd697cee6d`: 3 breaking
  - the `data/items/revenueAvg` response's property type changed from `integer` to `number`, and format from `int64` to `float` for status `200`
  - the `data/items/revenueHigh` response's property type changed from `integer` to `number`, and format from `int64` to `float` for status `200`
  - the `data/items/revenueLow` response's property type changed from `integer` to `number`, and format from `int64` to `float` for status `200`
- **2021-07-26** `0f755a71e903`: 5 info
  - added the optional property `data/items/numberAnalysts` to the response with the `200` status
  - added the optional property `data/items/period` to the response with the `200` status
  - added the optional property `data/items/revenueAvg` to the response with the `200` status
  - added the optional property `data/items/revenueHigh` to the response with the `200` status
  - …1 more
- **2021-07-23** `a148c0b2d583`: 1 info
  - api tag `Default` added
- …earlier changes not shown

[Operation history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/stock/revenue-estimate/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) - [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/revisions/415b27331384?raw)