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

# Earnings snapshot

`GET /api/earnings/snapshot`

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

One-call executive summary of a company's latest annual earnings. Includes core EPS, margins, returns,
cash quality, year-over-year growth, financial health scores (Piotroski F-Score, Altman Z-Score),
and the next earnings/filing dates.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string

## Response `200`

Comprehensive earnings snapshot for the latest annual period

- object
  - `symbol` string
  - `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)
  - `revenue` number, nullable — Total revenue in the requested currency (default USD)
  - `grossMargin` number, nullable — Gross margin as a percentage
  - `operatingMargin` number, nullable — Operating margin as a percentage
  - `netMargin` number, nullable — Net profit margin as a percentage
  - `roe` number, nullable — Return on equity as a percentage
  - `roic` number, nullable — Return on invested capital as a percentage
  - `freeCashFlow` number, nullable — Free cash flow in the requested currency (default USD)
  - `fcfToNetIncome` number, nullable — Free cash flow to net income ratio as a percentage (>100% = strong cash conversion)
  - `revenueGrowth` number, nullable — Year-over-year revenue growth as a decimal (0.02 = 2%)
  - `epsGrowth` number, nullable — Year-over-year EPS growth as a decimal
  - `netIncomeGrowth` number, nullable — Year-over-year net income growth as a decimal
  - `piotroskiFScore` integer — Piotroski F-Score (0-9). Higher is better. Measures financial strength using 9 binary criteria covering profitability, leverage, and operating efficiency.
  - `altmanZScore` number, nullable — Altman Z-Score for bankruptcy risk. >2.99 = safe, 1.81-2.99 = grey zone, <1.81 = distress.
  - `altmanZone` 'safe' | 'grey' | 'distress' — Altman Z-Score classification: `safe`, `grey`, or `distress`.
  - `nextEarningsDate` string, nullable — Next earnings date (YYYY-MM-DD) or null if unknown
  - `nextFilingDate` string, nullable — Projected next SEC filing date (YYYY-MM-DD) or null if unknown

## Other responses

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

---

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