KYB ověření českých firem přes API

Při onboardingu firemního klienta ověříte jeho IČO, stav a sídlo ve veřejném rejstříku jedním voláním a změny v rejstříku sledujete automaticky.

Proč je to v Česku důležité

Banky, platební instituce, účetní, advokáti, realitní makléři a další povinné osoby podle zákona č. 253/2008 Sb., o některých opatřeních proti legalizaci výnosů z trestné činnosti a financování terorismu, musí při navázání obchodního vztahu provést identifikaci a kontrolu klienta. U právnické osoby k tomu patří ověření její existence, názvu, sídla a právní formy. Ruční vyhledávání v rejstřících zdržuje onboarding a nezanechává stopu, kterou by mohl přezkoumat orgán dohledu.

Prometiam tuto část automatizuje: místo ručního hledání dostanete strukturovaný záznam, který uložíte do spisu klienta. Zákonné posouzení rizika a rozhodnutí o klientovi zůstává na vás.

Jak to funguje

  • GET /companies/search?country=CZ&company_number=... najde firmu podle IČO nebo podle názvu (name=).
  • GET /companies/{id} vrátí celý záznam; použijte id z vyhledávání.
  • GET /company-events/search?country=CZ&company_number=... vrátí změny názvu, stavu, právní formy, sídla a základního kapitálu.
  • POST /monitor zapne sledování klienta; změny přijdou webhookem.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CZ&company_number=45274649' \
  -H 'Authorization: Bearer rk_live_...'

Příklad používá IČO 45274649 (ČEZ, a. s.). Formát IČO si můžete vyzkoušet i bez klíče v nástroji pro vyhledání firmy podle IČO; jak IČO vzniká a co rejstřík eviduje, vysvětluje průvodce veřejným rejstříkem.

Co dostanete

PoleCo znamená
company_nameObchodní firma zapsaná v rejstříku
company_numberIČO, osmimístné identifikační číslo osoby
statusStandardizovaný stav (i likvidace, insolvence, konkurs a reorganizace)
local_statusStav tak, jak ho uvádí rejstřík
legal_form / local_legal_formPrávní forma, standardizovaná a v českém znění rejstříku
founding_dateDatum vzniku
adresaSídlo: ulice, obec, PSČ a kraj
share_capitalZákladní kapitál, jak je zapsán v rejstříku
activity_codeKód hlavní činnosti CZ-NACE 2025 z Registru ekonomických subjektů (ČSÚ)
registry_detailsRejstříkový soud a spisová značka (například B 1581, Městský soud v Praze)

Pole status je stejné pro všechny země, takže pravidla onboardingu napíšete jednou. Stav zahrnuje i likvidaci, insolvenci, konkurs a reorganizaci; firma v likvidaci nebo insolvenci tak ve vašem toku neprojde jako běžná aktivní společnost.

Průběžné sledování

Kontrola klienta nekončí podpisem smlouvy. Po zapnutí monitoringu přes POST /monitor se zemí CZ dostanete webhook při změně stavu, zániku, shodě se sankčním seznamem (beta) a při událostech v rejstříku, tedy při změně názvu, právní formy, sídla nebo základního kapitálu. Datum události je den, kdy se změna poprvé objevila v datech rejstříku; nejde o oznámení z věstníku a žádné události nejsou starší než první načtení v říjnu 2026.

Co pro Česko nedostanete

  • Žádné statutární orgány, společníky, akcionáře ani skutečné majitele: jde jen o záznamy o firmách. Identifikaci osob a skutečných majitelů řešíte z jiných zdrojů.
  • Žádný signál o plnění povinností vůči rejstříku.
  • Jen obchodní právnické osoby; spolky, nadace, svěřenské fondy, společenství vlastníků jednotek a pobočky ne.
  • OSVČ a jiné fyzické osoby se nevracejí nikdy.
  • Žádné DIČ: vyhledávání podle vat= pro Česko API odmítne.
  • Žádná insolvenční oznámení; insolvence a konkurs jsou jen ve stavu a v událostech.

Obsahuje data z veřejných rejstříků České republiky (Ministerstvo spravedlnosti, otevřená data ISVR) a Českého statistického úřadu (RES, CC BY 4.0). Upraveno společností Prometiam. Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam.

Jaký tarif se hodí

Na vyhledávání a záznamy stačí Starter (9,99 EUR měsíčně, 1 000 kreditů). Webhooky a plné ověřování sankcí (beta) přináší Professional (29,99 EUR měsíčně, 10 000 kreditů). Tarif Scale (99,99 EUR) přidává účetní závěrky. Všechny ceny jsou veřejné.

Související stránky

Začněte 14denní zkušební období · Dokumentace API

Zkušební období trvá 14 dní a zahrnuje 500 kreditů. Vyžaduje se platební karta, během zkušebního období se nic neúčtuje; poté pokračuje tarif Starter (9,99 EUR měsíčně), pokud jej nezrušíte.

Frequently asked questions

Nahrazuje API povinnou kontrolu klienta podle zákona č. 253/2008 Sb.?
Ne. Zjednodušuje ověření existence a stavu firmy a poskytuje auditní stopu. Posouzení rizika, zjištění skutečných majitelů a rozhodnutí o klientovi zůstávají na povinné osobě.
Dostanu i statutární orgány a skutečné majitele?
Ne. Pro Česko vracíme jen záznamy o firmách, bez statutárních orgánů, společníků a skutečných majitelů.
Jak zjistím, že je firma v likvidaci nebo insolvenci?
Zjistíte to v polích status a local_status a v událostech rejstříku. Samostatná insolvenční oznámení pro Česko neposkytujeme.
Vyhledává se i podle DIČ?
Ne. Vyhledávání podle vat= pro Česko API odmítne; používejte IČO nebo obchodní název.
Je zkušební období bez karty?
Ne. Trvá 14 dní, má 500 kreditů a vyžaduje kartu; během zkoušky se nic neúčtuje a poté pokračuje Starter (9,99 EUR měsíčně), pokud jej nezrušíte.