---
title: "Get Financial Score"
method: GET
path: "/financials/score/{symbol}"
tags: ["Financials"]
---

# Get Financial Score

`GET /financials/score/{symbol}`

## Request

- Base URL: `https://data.finbud.ai/api`
- URL: `https://data.finbud.ai/api/financials/score/{symbol}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/laksmono---company/apis/finbud-api/docs/financials/score/:symbol/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches the financial score for a given company stock symbol. The score provides a quick assessment of a company's financial health.

## Path parameters

- `symbol` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful response with financial score data.

- object[]
  - `symbol` string
  - `altman-z-score` number
  - `piotroski-score` number
  - `working-capital` number
  - `total-assets` number
  - `total-liabilities` number
  - `retained-earnings` number
  - `ebit` number
  - `revenue` number
  - `market-cap` number

## Other responses

- `400`: Bad Request - Symbol parameter missing.
- `404`: Not Found - The requested symbol does not exist or has no score data.
- `500`: Internal Server Error - Failed to fetch data or other server error.

---

[API](https://skmtc.dev/laksmono---company/apis/finbud-api.md) - [All operations](https://skmtc.dev/laksmono---company/apis/finbud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/laksmono---company/apis/finbud-api/revisions/742d2654c09a?raw)