Financial health scores

GET/api/financials/scores

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).

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

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

Responses

200 OK

Financial health scores from the most recent annual filing

Response schema

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 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
piotroskiFScore integer min 0 · max 9
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 | null
Altman Z-Score (null if insufficient data)
altmanZone object | null
Altman Z-Score classification: `safe`, `grey`, or `distress`.

Example response

{
  "period": "2024-09-28",
  "fiscalYear": 2025,
  "fiscalPeriod": {},
  "piotroskiFScore": 7,
  "piotroskiDetails": {
    "positiveNetIncome": true,
    "positiveOperatingCashFlow": true,
    "risingRoa": true,
    "cashFlowExceedsNetIncome": true,
    "decliningLeverage": false,
    "risingCurrentRatio": true,
    "noShareDilution": true,
    "risingGrossMargin": true,
    "risingAssetTurnover": false
  },
  "altmanZScore": 4.12,
  "altmanZone": {}
}

400 Bad Request

Invalid parameters, symbol not found, or company has no annual financial filings (e.g. SPACs, shell companies, pre-revenue companies)

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

{}