KYB overenie slovenských firiem cez API

Pri onboardingu firemného klienta overíte jeho IČO, stav a sídlo v RPO jedným volaním a zmeny v registri sledujete automaticky.

Prečo je to na Slovensku dôležité

Banky, platobné inštitúcie, účtovníci, advokáti či realitní makléri a ďalšie povinné osoby podľa zákona č. 297/2008 Z. z. o ochrane pred legalizáciou príjmov z trestnej činnosti musia pri nadviazaní obchodného vzťahu vykonať základnú starostlivosť voči klientovi, ktorá zahŕňa jeho identifikáciu a overenie identifikácie. Ručné vyhľadávanie v registroch zdržiava onboarding a nezanecháva stopu, ktorú by mohol preveriť orgán dohľadu.

Prometiam túto časť automatizuje: namiesto ručného hľadania dostanete štruktúrovaný záznam, ktorý uložíte k spisu klienta. Zákonné posúdenie rizika a rozhodnutie o klientovi ostáva na vás.

Ako to funguje

  • GET /companies/search?country=SK&company_number=... nájde firmu podľa IČO alebo podľa mena (name=).
  • GET /companies/{id} vráti celý záznam; použite id z vyhľadávania.
  • GET /company-events/search?country=SK&company_number=... vráti zmeny názvu, stavu, právnej formy a sídla.
  • POST /monitor zapne sledovanie klienta; zmeny prídu webhookom.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SK&company_number=35763469' \
  -H 'Authorization: Bearer rk_live_...'

Príklad používa IČO 35763469 (Slovak Telekom). Formát IČO si môžete vyskúšať aj bez kľúča v nástroji na vyhľadanie firmy podľa IČO; ako IČO vzniká a čo register eviduje, vysvetľuje sprievodca RPO.

Čo dostanete

PoleČo znamená
company_nameObchodné meno zapísané v registri
company_numberIČO, osemmiestne identifikačné číslo organizácie
statusŠtandardizovaný stav (aj konkurz a reštrukturalizácia)
local_statusStav tak, ako ho uvádza register
legal_form / local_legal_formPrávna forma, štandardizovaná a v slovenskom znení registra
founding_dateDátum vzniku
adresaSídlo: ulica, obec, PSČ
activity_codeKód hlavnej činnosti SK NACE, ak ho register uvádza

Pole status je rovnaké pre všetky krajiny, takže pravidlá onboardingu napíšete raz. Stav zahŕňa aj konkurz a reštrukturalizáciu; firma v konkurze alebo reštrukturalizácii tak vo vašom toku neprejde ako bežná aktívna spoločnosť.

Priebežné sledovanie

Povinná starostlivosť sa nekončí podpisom zmluvy. Po zapnutí monitoringu cez POST /monitor s krajinou SK dostanete webhook pri zmene stavu, zániku, zhode so sankčným zoznamom (beta) a pri udalostiach v registri, teda pri zmene názvu, právnej formy alebo sídla. Dátum udalosti je deň, keď sa zmena prvýkrát objavila v údajoch registra; nejde o oznam z vestníka a najstaršie udalosti sú od 30. septembra 2026.

Čo pre Slovensko nedostanete

  • Žiadnych štatutárov, spoločníkov ani skutočných vlastníkov: ide len o záznamy o firmách. Identifikáciu osôb a skutočných vlastníkov riešite z iných zdrojov.
  • Žiadny signál o plnení povinností voči registru.
  • Len obchodné právnické osoby; združenia, nadácie a iné nekomerčné subjekty nie.
  • Živnostníci a iné fyzické osoby sa nevracajú nikdy.
  • Žiadne číslo DPH: vyhľadávanie podľa vat= pre Slovensko API odmietne.
  • Žiadne oznamy o insolvencii; konkurz a reštrukturalizácia sú len v stave a v udalostiach.

Contains data from the Register of Legal Entities (RPO), Ministry of Interior and Statistical Office of the Slovak Republic, CC BY 4.0.

Aký plán sa hodí

Na vyhľadávanie a záznamy stačí Starter (9,99 EUR mesačne, 1 000 kreditov). Webhooky a plné overovanie sankcií (beta) prináša Professional (29,99 EUR mesačne, 10 000 kreditov). Plán Scale (99,99 EUR) pridáva účtovné závierky. Všetky ceny sú verejné.

Súvisiace stránky

Začnite 14-dňové skúšobné obdobie · Dokumentácia API

Skúšobné obdobie trvá 14 dní a zahŕňa 500 kreditov. Vyžaduje sa platobná karta, počas skúšobného obdobia sa nič neúčtuje; potom pokračuje plán Starter (9,99 EUR mesačne), ak ho nezrušíte.

Frequently asked questions

Nahrádza API povinnú starostlivosť podľa zákona 297/2008 Z. z.?
Nie. Zjednodušuje overenie existencie a stavu firmy a poskytuje auditnú stopu. Posúdenie rizika, identifikácia skutočných vlastníkov a rozhodnutie o klientovi zostávajú na povinnej osobe.
Dostanem aj štatutárov a skutočných vlastníkov?
Nie. Pre Slovensko vraciame len záznamy o firmách, bez štatutárov a spoločníkov.
Ako zistím, že je firma v konkurze?
Zistíte to v poli status a local_status a v udalostiach registra. Samostatné insolvenčné oznamy pre Slovensko neposkytujeme.
Vyhľadáva sa aj podľa DIČ alebo IČ DPH?
Nie. Vyhľadávanie podľa vat= pre Slovensko API odmietne; používajte IČO alebo obchodné meno.
Je skúšobné obdobie bez karty?
Nie. Trvá 14 dní, má 500 kreditov a vyžaduje kartu; počas skúšky sa nič neúčtuje a potom pokračuje Starter (9,99 EUR mesačne), ak ho nezrušíte.