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

# Financial health scores

`GET /api/financials/scores`

## Request

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

![Starter](https://img.shields.io/badge/Starter-3b82f6) ![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.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)