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

# Financial health scores chart

`GET /api/financials/chart/scores`

## Request

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

![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.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/6063af256548?raw)