1. Domov
  2. KYC/KYB API

KYC/KYB API pre Slovensko + Česko

Automatizované overenie 3.27M SK + CZ firiem cez jeden REST endpoint. Zákazník zadá IČO — API vráti štatutárov, UBO, sankcie, PEP, finančný dohľad, daňové signály a credit score. Integrácia za jeden deň.

Quickstart — 30s setup → OpenAPI spec Browse transparency feeds
3.27M
SK + CZ firiem
<100ms
Priemerná latencia
14
Dátových zdrojov
38
Compliance signálov

Čo dostaneš v jednom API calle

🏢 Identifikácia

Obchodné meno, IČO, DIČ, IČ DPH, LEI, právna forma, dátum vzniku, sídlo, NACE kód, stav likvidácie.

👤 Štatutári + UBO

Členovia štatutárneho orgánu, spoločníci, koneční užívatelia výhod (RPVS + UK Companies House PSC cross-border).

🚫 Sankcie + PEP

OFAC + EU + UN + UK + AMO kartel rozhodnutia + 1.1M PEP cez OpenSanctions. Cross-reference cez štatutárov a UBO.

💰 Financie

Tržby, EBITDA, čistý zisk, ROA, D/E ratio — 10-ročná timeline z RUZ. Credit score 0-100 + A-F grade.

⚖️ Compliance

Daňová spoľahlivosť (FS), daňové dlhy, dlhy v SocPoist + VšZP, NBS + ČNB finančný dohľad, NIS2 scoping (essential/important).

📜 Zmluvy + Súdne spory

CRZ verejné zmluvy (5.5M kontraktov), JUSTICE rozhodnutia, bankrot/reštrukturalizácia (OV 10-year timeline).

Príklad — jeden request vráti komplet KYB profile

# GET /api/v1/companies/:ico/full — 14 sekcií v jednej response
curl -H "Authorization: Bearer sk_..." \
  "https://entyrix.com/api/v1/companies/31322832/full"

# Response (zrátané)
{
  "data": {
    "profile":  { ico, name, registeredAt, nace, address, ... },
    "people":   [{ name, role, bornDecade, since }, ...],
    "ubo":      [{ name, sharePercent, source: "rpvs" }, ...],
    "sanctions": { directHits, personHits, hasOfac, hasPep, ... },
    "financials":[{ year, revenue, profit, ebitda, ratios }, ...],
    "compliance":{ level: "STANDARD", factors: [...] },
    "creditScore":{ score: 82, grade: "A", factors: [...] },
    "nis2":     { category: "essential", sector: "energy" },
    "contracts":{ count: 127, totalEur: 48293001, lastDate: "2026-04-08" },
    "taxReliability": "vysoko spoľahlivý",
    "debts":    { social: 0, health: 0, taxes: 0 }
  }
}

Typické use cases

🏦 Fintech onboarding

Automatický KYB check pri otváraní účtu. Stop-list pre sankcie / PEP, flag high-risk compliance kategórie, skrátiť manuálnu review zo dní na sekundy.

📊 B2B credit scoring

Pred uzavretím kontraktu over bonitu partnera: credit score, daňové dlhy, finančnú trajektóriu, CRZ public-contract volume.

🛡️ NIS2 consulting

Identifikuj essential/important entity v klientskej báze. Ktorí potrebujú cyber incident reporting do 24h? Interaktívny check: /nis2-checker, alebo API /companies/:ico/nis2 + /nis2-obligations.

📈 Sales intelligence

Advanced-search filter → "SK firmy, NACE 62, credit A-B, LEI, bez sankcií, turnover 1M+". CSV export 38 stĺpcov pre CRM import.

FAQ

Aké dáta dostanem na jedno IČO?
Registrácia (RPO/ARES), štatutári + spoločníci, UBO (RPVS + UK PSC cross-border), finančné ukazovatele (tržby, EBITDA, ROA), daňová spoľahlivosť, dlhy SocPoist + VšZP, bankrot/reštrukturalizácia (OV), verejné zmluvy (CRZ), sankcie (OFAC + EU + UN + UK), PEP linky, NBS/ČNB finančný dohľad, NIS2 scoping, credit score 0-100. Všetko v 1 JSON endpoint cez /api/v1/companies/:ico/full.
Koľko stojí?
Free tier: 600 requests/min pre všetky public endpointy bez auth kľúča (stats, rankings, data-feeds). Paid tier pre authenticated endpointy (per-company detail, advanced-search, bulk lookup) — pricing ešte finalizujeme, launch plánovaný Q2 2026. Kontakt: [email protected].
Ako dlho trvá integrácia?
Jeden deň. Copy-paste curl/Python/TypeScript/PHP primery v /quickstart, plný OpenAPI 3.1 spec v /openapi.json, Postman collection v /api/v1/public/postman.json. Bulk endpoint POST /companies/bulk berie 100 IČO naraz (10ms each).
Pokrývate aj EÚ firmy mimo SK/CZ?
Cross-border dáta áno (GLEIF LEI 39k, OpenSanctions 1.1M targets, UK Companies House PSC pre UBO). Full registrácia mimo SK/CZ je v pláne (fáza B-E): CZ deep pilot Q2-Q3 2026, potom EE + SI, followed by HR/PL/LV/LT. DE/FR/IT/ES demand-gated (scraping legal risk bez customer contractu).
Je to GDPR compliant?
Áno. Dáta pochádzajú výlučne zo štátnych otvorených dát (RPO, RUZ, FS, OV, RPVS, NBS, ARES, ČNB, CRZ, GLEIF, OpenSanctions, ITMS). Každý endpoint má pri sebe licenciu (CC-BY 4.0, CC0, CC-BY-NC-ND podľa zdroja). Osobné údaje sú iba tie, ktoré zákon vyžaduje zverejniť (štatutári, UBO nad 25%). Žiadne dáta zo sociálnych sietí ani behaviorálny tracking.
Čo ak firma nemá IČO (SZČO, zahraničný dodávateľ)?
SZČO (živnosť) má IČO (8-miestne) rovnako ako právnické osoby — pokryté. Pre zahraničných dodávateľov validujeme cez VIES VAT endpoint (/api/v1/vat/validate?country=DE&vatin=...) ktorý overí aktívnu DPH registráciu v 27 EÚ štátoch. Pre UK máme Companies House PSC crossreference cez /companies/:ico/uk-connections.
Ako rieši service high volume (100k+ lookups / mesiac)?
Bulk POST /companies/bulk (100 ICO / request, 10ms/each). Pre full table exports použite CSV feedy v /data-feeds (denne aktualizované, 50+ stĺpcov vrátane compliance signálov). Advanced-search CSV export podporuje až 10k riadkov / request s 38 stĺpcami. Rate limit 600 req/min štandardne, vyšší po dohode.

Ďalšie kroky