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

# Financial health scores chart

`GET /api/financials/chart/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 chart-ready data for financial health scores over time: Piotroski F-Score (0–9) and Altman Z-Score. Annual periods only.
Each period requires a prior year for Piotroski YoY comparisons, so internally fetches `limit + 1` periods.
Altman Z-Score may be null for periods with insufficient balance sheet data.

## Query parameters

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

## Response `200`

Series-oriented chart data with periods sorted ascending

- object
  - `periods` string[], required — Reporting period end dates (YYYY-MM-DD), sorted ascending. Each entry corresponds index-wise to the values in every `series.data` array. Annual periods only.
  - `series` object[], required — Always returns two entries — `Piotroski F-Score` (integer 0–9, higher is better) and `Altman Z-Score` (decimal; >2.99 = safe zone, 1.81–2.99 = grey zone, <1.81 = distress zone) — in that order. Altman Z-Score may be `null` for periods where required balance sheet items aren't tagged. Piotroski may be `null` only when the prior-year comparison values are missing.
    - `name` 'Piotroski F-Score' | 'Altman Z-Score', required
    - `data` number[], required

## Other responses

- `400` — Invalid parameters or symbol not found
- `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)