The Scorvest API

Financial health scores, their five areas and the main ratios, as JSON, for your spreadsheets, internal tools and apps.

Access

The API is included in the Pro plan, with 5000 requests a day. Create your key from "My account" and send it in the Authorization header.

Authorization: Bearer sv_live_…

Need higher volumes or a redistribution licence? See the business offer →

Endpoints

GET /api/v1/company/{id}

One company: score, areas, ratios, score history and official source.

curl -H "Authorization: Bearer sv_live_…" https://scorvest.com/api/v1/company/aapl

GET /api/v1/scores?ids=aapl,msft,…

Up to 25 companies per call (without history).

curl -H "Authorization: Bearer sv_live_…" "https://scorvest.com/api/v1/scores?ids=aapl,msft,tw-2330"

GET /api/v1/rankings?country=US&sector=tech&min_score=70&limit=100

The ranking of the large companies followed, filterable by country, sector and minimum score (up to 1,000 rows).

curl -H "Authorization: Bearer sv_live_…" "https://scorvest.com/api/v1/rankings?country=FR&min_score=70"

Response

{
  "data": {
    "id": "aapl",
    "name": "Apple Inc.",
    "country": "US",
    "currency": "USD",
    "fiscal_year": 2025,
    "score": 81,
    "grade": "Strong",
    "pillars": { "profitability": 92, "strength": 63, "cash": 95, "stability": 84, "growth": 58 },
    "ratios": { "operating_margin": 0.32, "roe": 1.5, "net_debt_to_ebitda": 0.4, "altman_z": 4.1, "piotroski_f": 7, "…": "…" },
    "score_history": [{ "fiscal_year": 2024, "score": 79 }, { "fiscal_year": 2025, "score": 81 }],
    "last_filed": "2025-10-31",
    "source": { "name": "SEC EDGAR", "url": "https://www.sec.gov/…" }
  }
}

Illustrative values. Ratios are decimals (0.32 = 32%). Identifiers are those in the site's URLs: US ticker (aapl), European LEI, or a country prefix (br-, kr-, jp-, tw-).

Python

import requests

KEY = "sv_live_…"
r = requests.get("https://scorvest.com/api/v1/scores", params={"ids": "aapl,msft"},
                 headers={"Authorization": f"Bearer {KEY}"})
for c in r.json()["data"]:
    print(c["name"], c["score"])

Terms

What the API contains: The scores, areas and ratios computed by Scorvest. Raw financial statements are not redistributed: each answer links to the official source.
Use: Internal use by the subscriber. Reselling or publishing the data requires a business licence.
Limits: 5000 requests a day per account; the X-RateLimit-Remaining header shows what is left.
Disclaimer: General information, with no guarantee of accuracy, not investment advice.

Get started with the Pro plan.

See the Pro plan Create my key