---
title: "EPS history"
method: GET
path: "/api/earnings/eps-history"
tags: ["Earnings"]
---

# EPS history

`GET /api/earnings/eps-history`

## Request

- Base URL: `https://api.stockfit.io/v1`
- URL: `https://api.stockfit.io/v1/api/earnings/eps-history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/stockfit/apis/stockfit-api/docs/api/earnings/eps-history/get.ts> (a function with typed inputs; its response is checked against the schema)

![Free](https://img.shields.io/badge/Free-22c55e) ![Starter](https://img.shields.io/badge/Starter-3b82f6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Returns earnings per share over time with basic and diluted EPS, net income, share counts, and year-over-year growth.
Data is sourced from SEC XBRL filings (10-K and 10-Q). Periods are sorted most recent first.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string
- `period` 'annual' | 'quarter' | 'ttm': Reporting period: `annual`, `quarter`, or `ttm` (trailing twelve months). TTM sums the last 4 quarters for flow items and uses the latest quarter for point-in-time items.
- `limit` integer
- `splitAdjust` boolean

## Response `200`

Array of EPS history entries sorted most recent first

- object[]
  - `period` string: Fiscal period end date (YYYY-MM-DD)
  - `fiscalYear` integer: The company's fiscal year (handles non-December year-ends, AAPL FY ends Sep, COST FY ends Aug).
  - `fiscalPeriod` 'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'TTM': Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).
  - `eps` number, nullable: Basic earnings per share
  - `epsDiluted` number, nullable: Diluted earnings per share
  - `netIncome` number, nullable: Net income in the requested currency (default USD)
  - `sharesOutstanding` number, nullable: Basic weighted average shares outstanding
  - `sharesOutstandingDiluted` number, nullable: Diluted weighted average shares outstanding
  - `epsGrowth` number, nullable: EPS growth versus the previous period in the series, as a decimal (0.11 = 11%): period-over-period, so year-over-year when period=annual and quarter-over-quarter when period=quarter.

## Other responses

- `400`: Invalid parameters or symbol not found
- `403`: Feature not available on current plan

---

[API](https://skmtc.dev/stockfit/apis/stockfit-api.md) - [All operations](https://skmtc.dev/stockfit/apis/stockfit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockfit/apis/stockfit-api/revisions/ade8e65563c3?raw)