---
title: "Earnings"
method: GET
path: "/earnings"
tags: ["fundamentals"]
---

# Earnings

`GET /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.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `exchange` string
- `mic_code` string
- `country` string
- `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'
- `period` 'latest' | 'next'
- `outputsize` integer
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `start_date` string
- `end_date` string
- `dp` integer

## Response `200`

- object
  - `meta` object, required — Metadata about the instrument
    - `symbol` string, required — Symbol of the instrument
    - `name` string, required — Name of the company
    - `currency` string, required — Currency in which the instrument is traded
    - `exchange` string, required — Exchange where the instrument is traded
    - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
    - `exchange_timezone` string, required — Timezone of the exchange
  - `earnings` EarningsItem[], required — List of earnings data
    - `date` string, required — Date of earning release
    - `time` string — Time of earning release, can be either of the following values: `Pre Market`, `After Hours`, `Time Not Supplied`
    - `eps_estimate` number, double — Analyst estimate of the future company earning
    - `eps_actual` number, double — Actual value of reported earning
    - `difference` number, double — Delta between `eps_actual` and `eps_estimate`
    - `surprise_prc` number, double — Surprise in the percentage of the `eps_actual` related to `eps_estimate`
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)