Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

fundamentals

Earnings

The earnings endpoint provides comprehensive earnings data for a specified company, including both the estimated and actual Earnings Per Share (EPS) figures. This endpoint delivers historical earnings information, allowing users to track a company's financial performance over time.

get/earnings

Query parameters

symbolstring

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

exchangestring

Exchange where instrument is traded

mic_codestring

Market Identifier Code (MIC) under ISO 10383 standard

countrystring

Country where instrument is traded, e.g., United States or US

type'American Depositary Receipt' | 'Bond' | 'Bond Fund' | 'Closed-end Fund' | 'Common Stock' | 'Depositary Receipt' | 'Digital Currency' | 'ETF' | 'Exchange-Traded Note' | 'Global Depositary Receipt' | 'Limited Partnership' | 'Mutual Fund' | 'Physical Currency' | 'Preferred Stock' | 'REIT' | 'Right' | 'Structured Product' | 'Trust' | 'Unit' | 'Warrant'

The asset class to which the instrument belongs

period'latest' | 'next'

Type of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored

outputsizeinteger

Number of data points to retrieve. Supports values in the range from 1 to 1000. Default 10 when no date parameters are set, otherwise set to maximum

format'JSON' | 'CSV'

The format of the response data

delimiterstring

The separator used in the CSV response data

start_datestring

The date from which the data is requested. The date format is YYYY-MM-DD.

end_datestring

The date to which the data is requested. The date format is YYYY-MM-DD.

dpinteger

The number of decimal places in the response data. Should be in range [0,11] inclusive

Response

statusstring required

Response status

Example response

{
  "meta": {
    "symbol": "AAPL",
    "name": "Apple Inc",
    "currency": "USD",
    "exchange": "NASDAQ",
    "mic_code": "XNAS",
    "exchange_timezone": "America/New_York"
  },
  "earnings": [
    {
      "date": "2020-04-30",
      "time": "After Hours",
      "eps_estimate": 2.09,
      "eps_actual": 2.55,
      "difference": 0.46,
      "surprise_prc": 22.01
    }
  ],
  "status": "ok"
}