# Growth estimates

The growth estimates endpoint provides consensus analyst projections on a company's growth rates over various timeframes. It aggregates and averages estimates from multiple analysts, focusing on key financial metrics such as earnings per share and revenue. This endpoint is useful for obtaining a comprehensive view of expected company performance based on expert analysis.

**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)
  The FIGI of an instrument for which data is requested. 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)
  The country where the instrument is traded, e.g., `United States` or `US`


- `exchange` (string, optional)
  Exchange where instrument is traded


**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

- `growth_estimates` (object)
  Growth estimates data
  - `current_quarter` (number)
    Projected growth of the current quarter in percentage (%)
  - `next_quarter` (number)
    Projected growth of the next quarter in percentage (%)
  - `current_year` (number)
    Projected growth of the current year in percentage (%)
  - `next_year` (number)
    Projected growth of the next year in percentage (%)
  - `next_5_years_pa` (number)
    Projected growth during the next 5 years in percentage (%) per annum
  - `past_5_years_pa` (number)
    Actual growth over the last 5 years in percentage (%) per annum

- `status` (string)
  Status of the request


## Example Request

```bash
curl "https://api.twelvedata.com/growth_estimates?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"
    },
    "growth_estimates": {
        "current_quarter": 0.016,
        "next_quarter": 0.01,
        "current_year": 0.087,
        "next_year": 0.055999998,
        "next_5_years_pa": 0.094799995,
        "past_5_years_pa": 0.23867
    },
    "status": "ok"
}
```