# Revenue estimate

The revenue estimate endpoint provides a company's projected quarterly and annual revenue figures based on analysts' estimates. This data is useful for users seeking insights into expected company performance, allowing them to compare forecasted sales with historical data or other companies' estimates.

**API credits cost:** `20` per symbol

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Filter by symbol


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `exchange` (string, optional)
  Filter by exchange name


- `dp` (integer, optional)
  Number of decimal places for floating values.
Should be in range [0,11] inclusive


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the symbol
  - `symbol` (string)
    Symbol ticker of the instrument
  - `name` (string)
    Name of the instrument
  - `currency` (string)
    Currency in which the instrument is traded
  - `exchange_timezone` (string)
    Timezone of the exchange
  - `exchange` (string)
    Exchange where the instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `type` (string)
    Type of the instrument

- `revenue_estimate` (array of object)
  Revenue estimate data
  - `date` (string)
    Date of the estimate
  - `period` (string)
    Period of estimation, can be `current_quarter`, `next_quarter`, `current_year`, or `next_year`
  - `number_of_analysts` (integer)
    Number of analysts that made the estimation
  - `avg_estimate` (number)
    Average estimation across analysts
  - `low_estimate` (number)
    Lowest estimation given by an analyst
  - `high_estimate` (number)
    Highest estimation given by an analyst
  - `year_ago_sales` (number)
    Total revenue received a year ago relative to period
  - `sales_growth` (number)
    Estimated sales growth of the period in relation to year-ago sales in prc (%)

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/revenue_estimate?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange_timezone": "America/New_York",
        "exchange": "NASDAQ",
        "mic_code": "XNGS",
        "type": "Common Stock"
    },
    "revenue_estimate": [
        {
            "date": "2022-09-30",
            "period": "current_quarter",
            "number_of_analysts": 24,
            "avg_estimate": 88631500000,
            "low_estimate": 85144300000,
            "high_estimate": 92794900000,
            "year_ago_sales": 83360000000,
            "sales_growth": 0.06
        }
    ],
    "status": "ok"
}
```