# Earnings estimate (Useful)

The earnings estimate endpoint provides access to analysts' projected earnings per share (EPS) for a specific company, covering both upcoming quarterly and annual periods. This data is crucial for users who need to track and compare expected financial performance across different timeframes, aiding in the evaluation of a company's future profitability.

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


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


- `country` (string, optional)
  The country where the instrument is traded, e.g., `United States` or `US`


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

- `earnings_estimate` (array of object)
  List of earnings estimates
  - `date` (string)
    Date of the earnings 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_eps` (number)
    Average estimation of this period's earnings given a year ago

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/earnings_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"
    },
    "earnings_estimate": [
        {
            "date": "2022-09-30",
            "period": "current_quarter",
            "number_of_analysts": 27,
            "avg_estimate": 1.26,
            "low_estimate": 1.13,
            "high_estimate": 1.35,
            "year_ago_eps": 1.24
        }
    ],
    "status": "ok"
}
```