1. Domov
  2. Company Credit Score

B2B Credit Score API weekly refresh

Composite credit rating 0-100 + A-F grade pre 1,278,763 SK + CZ firiem. Derivované z finančných výkazov + tax compliance + konkurzov + sankcií. Per-faktor breakdown, <100ms API, free tier 600 req/min bez auth kľúča.

Credit check jedným IČO

Zadaj IČO → dostaneš score + grade + top 3 factors (pozitívne aj negatívne).

Coverage na SK + CZ databáze

1,278,763
firiem so score
65
priemer skóre (0-100)
9,045
s finančnými výkazmi
75,783
s daňovým dlhom

Rozdelenie podľa grade

A+
130,497
10.2 %
90-100 / Top-tier
A
336,275
26.3 %
80-89 / Strong
B
327,327
25.6 %
70-79 / Baseline
C
94,364
7.4 %
55-69 / Caution
D-F
390,300
30.5 %
<55 / High risk

Čo ide do skóre (top factors)

💰 Turnover + profit +0 až +12

RUZ tržby za posledný rok + čistý zisk. Bonus za tržby >€1M a pozitívny profit. Bez finančných výkazov = neutrál.

📈 ROA + Debt/Equity +0 až +8

Return on Assets (>5 % = silný operator) + D/E ratio (<1 = zdravá kapitálová štruktúra). Počítané z najnovšej šablóny 699.

🏛️ Tax reliability +0 až +5

FS spoľahlivosť triedy: "vysoko spoľahlivý" +5, "spoľahlivý" +3, "menej spoľahlivý" 0. Signál že FS nezachytila významné porušenia.

📜 Public contracts +0 až +5

CRZ verejné zmluvy — firma pravidelne obchoduje so štátom. Bonus za contract v posledných 12 mesiacoch. RPVS UBO registrácia +2.

📅 Vek firmy +0 až +4

>10y v biznise = +4 (established). 5-10y = +2. <2y = 0 (neutrál). Korelácia s survival rate.

💸 Tax debt −5 až −20

FS daňový dlh — scale podľa sumy. <€1k = −5, €1-10k = −10, >€10k = −20. Hard signal o cashflow issues.

🏥 Insurance debts −3 až −15

SocPoist + VšZP dlhy. Nepriamy cashflow signál (firmy nestíhajú odvody). Kumulatívna scale.

⚖️ Likvidácia / reštrukturalizácia −20 až −40

RPO/OV flag in_liquidation=true alebo in_restructuring=true. Firma v procese — vysoké riziko default.

🚨 Konkurz HARD-STOP ≤10

OV in_bankruptcy=true — score sa nastaví na max 10 (grade F). Aktuálne 19,451 firiem v konkurze.

🛑 Sankcia / debarment HARD-STOP ≤5

OpenSanctions hit (OFAC/EU/UN/UK HMT) alebo World Bank/EU debarment. Score ≤5, grade F, PROHIBITED compliance tier.

API response shape

GET /api/v1/companies/31322832/credit-score

{
  "data": {
    "ico": "31322832",
    "name": "SLOVNAFT, a.s.",
    "score": 91,
    "grade": "A+",
    "baseline": 70,
    "factors": [
      { "name": "turnover",        "delta": +12, "note": "€4.2B" },
      { "name": "profit",          "delta": +8,  "note": "€180M net" },
      { "name": "tax_reliability", "delta": +5,  "note": "vysoko spoľahlivý" },
      { "name": "age",             "delta": +4,  "note": "31 rokov" },
      { "name": "public_contracts", "delta": +3, "note": "146 zmlúv" }
    ],
    "warnings": [],
    "hardStop": null,
    "computedAt": "2026-04-23T07:10:00Z"
  },
  "meta": { "duration_ms": 42, "cached": false }
}

Typické use cases

💼 B2B sales pre-qual

Predtým ako investujete hodiny do proposalu: auto-check credit pri lead qualification. C/D/E leads dostanú shorter trial, A/A+ priority treatment.

🧾 Accounts Receivable

Pre-invoice risk scoring: D-F clients = cash-on-delivery alebo pre-paid. A/A+ = 60d NET. Zníži DSO + bad debt write-offs.

🛒 Procurement / Supplier onboarding

Pre-qual suppliers pri RFP / framework contract. Minimálne B (70+) pre contract >€50k. Bulk score celého vendor base mesačne.

🏦 Fintech underwriting

SMB lending / factoring pre-approval. Score + factor breakdown → decision engine input. Sanctions/bankruptcy hard-stop auto-reject.

FAQ

Z čoho počítate credit score?
Z dát, ktoré už zbierame denne/týždenne: RUZ finančné výkazy (tržby, profit, ROA, ROE, debt/equity), FS tax compliance (tax reliability trieda + tax debts), OV (konkurz/reštrukturalizácia/likvidácia flags), SocPoist + VšZP dlhy, CRZ public contract history (pozitívny signál dôvery verejného sektora), vek firmy, RPVS UBO registrácia. Hard-stop na OpenSanctions hit (sankcie/debarment → score ≤10). Baseline 70, každý faktor ± delta, clamp 0-100. Full factor breakdown per firma v API response.
Ako interpretujem A-F grade?
A+ (≥90): Top-tier, excellent financial health, clean compliance. ~130,497 firiem. A (80-89): Strong performer, minor watch items. ~336,275. B (70-79): Stable, priemer (baseline). ~327,327. C (55-69): Caution — 1-2 negatívne signály (tax debt / deklinujúci profit). ~94,364. D (40-54): Elevated risk — viacero issues. E (20-39): High risk — likvidácia/restrukturalizácia / vysoké dlhy. F (<20): Distress — bankrot / sankcia / viaceré hard-stops. D-F spolu ~390,300.
Je to regulovaný credit rating (ESMA / SEC NRSRO)?
Nie. Nie sme registrovaný credit rating agency podľa EU Regulation 1060/2009 (CRA Regulation) ani ESMA-supervised. Je to analytical credit score určený pre internú B2B risk assessment — pre-trade counterparty check, AR underwriting, procurement pre-qual. Nepoužívajte pre regulatorne vyžadované účely (solvency II kapitál, Basel III IRB ratings, verejné bond ratings). Pre tie potrebujete Moody's / S&P / Fitch / Scope. Náš score replikuje podobnú logiku za zlomok ceny pre B2B sales/treasury/AR teams.
Ako často sa skóre aktualizuje?
Týždenne. Weekly timer opendata-credit-scores.timer (Mon 07:10 UTC) recompute-ne skóre pre firmy so stale dátami (--only-stale). Full refresh po mesačnom ARES / RUZ update. Per-company credit_score_updated_at timestamp dostanete v API. Pre real-time rescoring po nejakom trigger eventu (napríklad OV bankruptcy publish) support bude v DS-45 Monitoring (webhook on credit_grade change).
Dostanem factor-level vysvetlenie, prečo firma má dané score?
Áno. GET /api/v1/companies/:ico/credit-score vracia factors[] array — každý faktor má {name, delta, note}. Napríklad [{name: 'turnover', delta: +8, note: '€2.4M'}, {name: 'tax_reliability', delta: +5, note: 'vysoko spoľahlivý'}, {name: 'tax_debt', delta: -12, note: '€48k'}]. Plus baseline (70), hardStop (null alebo reason), warnings[], computedAt. Pre audit trail + explainability — user-facing UI môže zobraziť "ako vznikol score".
Môžem bulk-skórovať celú vendor base (100-1000 firiem)?
Áno. POST /api/v1/companies/bulk berie 100 IČO / request (batch 10ms/each = ~1s na 100 firiem). Full response obsahuje credit_score + credit_grade. Pre väčšie batch (10k+) použite GET /api/v1/companies/advanced-search.csv?credit_grade=D,E,F CSV export (38 stĺpcov vrátane finančných). Alebo /companies/advanced-search?min_credit_score=80&max_credit_score=100 pre high-tier supplier shortlist.
Ako porovnať score s inými ratingovými modelmi?
Náš 0-100 má rough equivalenciu: 90-100 (A+) ≈ S&P A / Moody's A2 / Scope A — investment grade top quartile. 70-89 (B/A) ≈ BBB- do A- — investment grade lower. 55-69 (C) ≈ BB / Ba2 — speculative. 40-54 (D) ≈ B/B1 — high yield. <40 (E/F) ≈ CCC/C alebo default. Toto je orientačný mapping, pre SMB segment. Our score je viac compliance-heavy (sanctions hard-stop, tax debt penalty) než klasický rating agency model, ktorý váži hlavne default probability.

Ďalšie kroky