---
title: "Financial health scores"
method: GET
path: "/api/financials/scores"
tags: ["Financials"]
---

# Financial health scores

`GET /api/financials/scores`

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

Returns two well-known financial health scores computed from the company's most recent annual filings:

**Piotroski F-Score** (0–9): A composite score measuring financial strength across 9 binary criteria in three categories:

| Category | Criteria | Signal |
|----------|----------|--------|
| Profitability | Positive net income | +1 |
| Profitability | Positive operating cash flow | +1 |
| Profitability | Rising return on assets (YoY) | +1 |
| Profitability | Cash flow exceeds net income (earnings quality) | +1 |
| Leverage | Declining debt-to-assets ratio (YoY) | +1 |
| Leverage | Rising current ratio (YoY) | +1 |
| Leverage | No share dilution (YoY) | +1 |
| Efficiency | Rising gross margin (YoY) | +1 |
| Efficiency | Rising asset turnover (YoY) | +1 |

Scores 7–9 indicate strong financial health; 0–3 indicate weakness.

**Altman Z-Score**: A bankruptcy prediction model using 5 weighted ratios:
`Z = 1.2×(Working Capital/Assets) + 1.4×(Retained Earnings/Assets) + 3.3×(EBIT/Assets) + 0.6×(Equity/Liabilities) + 1.0×(Revenue/Assets)`

| Zone | Z-Score | Interpretation |
|------|---------|----------------|
| Safe | > 2.99 | Low bankruptcy risk |
| Grey | 1.81 – 2.99 | Moderate risk, needs monitoring |
| Distress | < 1.81 | High bankruptcy risk |

Note: The equity component uses book value of equity as a proxy (market capitalization is not available).

## Query parameters

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

## Response `200`

Financial health scores from the most recent annual filing

- object
  - `period` string — The fiscal year end date used for computation
  - `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).
  - `piotroskiFScore` integer — Piotroski F-Score (0–9)
  - `piotroskiDetails` object — Individual Piotroski criteria results
    - `positiveNetIncome` boolean
    - `positiveOperatingCashFlow` boolean
    - `risingRoa` boolean
    - `cashFlowExceedsNetIncome` boolean
    - `decliningLeverage` boolean
    - `risingCurrentRatio` boolean
    - `noShareDilution` boolean
    - `risingGrossMargin` boolean
    - `risingAssetTurnover` boolean
  - `altmanZScore` number, nullable — Altman Z-Score (null if insufficient data)
  - `altmanZone` 'safe' | 'grey' | 'distress' — Altman Z-Score classification: `safe`, `grey`, or `distress`.

## Other responses

- `400` — Invalid parameters, symbol not found, or company has no annual financial filings (e.g. SPACs, shell companies, pre-revenue companies)
- `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)