Pricing Blog Insights Playground
Dashboard

Earnings snapshot

GET/api/earnings/snapshot

Starter Stock Pro

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 predicted next earnings/filing dates.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/earnings/snapshot?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8&currency=USD' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Comprehensive earnings snapshot for the latest annual period

Response schema

  • 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 string (enum)

    Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).

    Allowed values: FY, Q1, Q2, Q3, Q4, TTM
  • eps number | null

    Basic earnings per share

  • epsDiluted number | null

    Diluted earnings per share

  • netIncome number | null

    Net income in the requested currency (default USD)

  • revenue number | null

    Total revenue in the requested currency (default USD)

  • grossMargin number | null

    Gross margin as a percentage

  • operatingMargin number | null

    Operating margin as a percentage

  • netMargin number | null

    Net profit margin as a percentage

  • roe number | null

    Return on equity as a percentage

  • roic number | null

    Return on invested capital as a percentage

  • freeCashFlow number | null

    Free cash flow in the requested currency (default USD)

  • fcfToNetIncome number | null

    Free cash flow to net income ratio as a percentage (>100% = strong cash conversion)

  • revenueGrowth number | null

    Year-over-year revenue growth as a decimal (0.02 = 2%)

  • epsGrowth number | null

    Year-over-year EPS growth as a decimal

  • netIncomeGrowth number | null

    Year-over-year net income growth as a decimal

  • piotroskiFScore integer min 0 · max 9

    Piotroski F-Score (0-9). Higher is better. Measures financial strength using 9 binary criteria covering profitability, leverage, and operating efficiency.

  • altmanZScore number | null

    Altman Z-Score for bankruptcy risk. >2.99 = safe, 1.81-2.99 = grey zone, <1.81 = distress.

  • altmanZone object | null

    Altman Z-Score classification: `safe`, `grey`, or `distress`.

    • nextEarningsDate string | null

      Predicted next earnings call date (YYYY-MM-DD) or null if unknown

    • nextFilingDate string | null

      Predicted next SEC filing date (YYYY-MM-DD) or null if unknown

    Example response

    {
  "symbol": "AAPL",
  "period": "2024-09-28",
  "fiscalYear": 2025,
  "fiscalPeriod": {},
  "eps": 6.08,
  "epsDiluted": 6.04,
  "netIncome": 93736000000,
  "revenue": 391035000000,
  "grossMargin": 46.23,
  "operatingMargin": 31.51,
  "netMargin": 23.97,
  "roe": 127.15,
  "roic": 57.42,
  "freeCashFlow": 108807000000,
  "fcfToNetIncome": 116.09,
  "revenueGrowth": 0.0202,
  "epsGrowth": 0.1068,
  "netIncomeGrowth": 0.0843,
  "piotroskiFScore": 6,
  "altmanZScore": 5.72,
  "altmanZone": {},
  "nextEarningsDate": "2026-04-24",
  "nextFilingDate": "2026-05-01"
}

    400 Bad Request

    Invalid parameters or symbol not found

    Response schema

    • error string

      Human-readable error message

    Example response

    {}

    403 Forbidden

    Feature not available on current plan

    Response schema

    • error string

      Human-readable error message

    Example response

    {}