latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

Financials

Financial health 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/financials/scores

Query parameters

symbolstring

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

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

Response

Financial health scores from the most recent annual filing

periodstring

The fiscal year end date used for computation

fiscalYearinteger

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

piotroskiFScoreinteger

Piotroski F-Score (0–9)

altmanZScorenumber nullable

Altman Z-Score (null if insufficient data)

altmanZone'safe' | 'grey' | 'distress'

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

Example response

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