API registra firiem
Prepojte údaje o slovenských firmách priamo so svojimi systémami. Jedna požiadavka podľa IČO vráti základné údaje, štatutárny orgán, spoločníkov a ukazovatele z účtovných závierok v jednej štruktúrovanej odpovedi JSON. Nemusíte sami spracúvať hromadné súbory RPO, sťahovať závierky z RÚZ a spájať ich.
Čo získate
Celý profil firmy v jednej odpovedi alebo len potrebné bloky (fields=), aby odpoveď zostala malá.
Vyhľadávanie podľa názvu alebo IČO, ktoré zvláda diakritiku aj preklepy, s výsledkami podľa relevancie.
Tržby, výsledok hospodárenia, vlastné imanie, aktíva, zamestnanci a ukazovatele v strojovo čitateľnej podobe. Bez čítania PDF.
Štatutári a spoločníci s obdobím platnosti, takže vidíte aj zmeny v minulosti.
API kľúče (Bearer), viac kľúčov pre tím alebo prostredie, prehľad využitia.
Stavy, právne formy a funkcie aj v angličtine (lang=en).
Ukážka požiadavky a odpovede
GET https://icoprofil.sk/api/v1/firma/12345678?fields=zakladne,osoby,zavierky
Authorization: Bearer ent_…
{
"ico": "12345678",
"nazov": "Príklad s.r.o.",
"stav": "Aktívna",
"pravna_forma": "Spoločnosť s ručením obmedzeným",
"sk_nace": { "kod": "62010", "text": "Počítačové programovanie" },
"osoby": [
{ "meno": "Ján Novák", "funkcia": "Konateľ", "od": "2019-04-01" },
{ "meno": "Príklad Holding s.r.o.", "funkcia": "Spoločník", "vklad_eur": 5000 }
],
"zavierky": [
{ "rok": 2025, "trzby": 1840000, "vysledok": 212000, "zamestnanci": 14 },
{ "rok": 2024, "trzby": 1515000, "vysledok": 164000, "zamestnanci": 12 }
]
}Údaje
- Základné údaje: názov, IČO, právna forma, stav, dátum vzniku, sídlo, hlavná činnosť (SK NACE), základné imanie
- Osoby: štatutárny orgán, dozorná rada a spoločníci s vkladom a obdobím platnosti (o fyzických osobách len meno, funkcia a vklad)
- Účtovné závierky podľa rokov (RÚZ): tržby, výsledok hospodárenia, vlastné imanie, súvaha, počet zamestnancov, finančné ukazovatele
- Kód LEI a jeho stav
Príklady použitia
Automaticky overte stav, štatutárov a spoločníkov nového firemného klienta už v registračnom formulári.
Vyplňte kartu firmy podľa IČO a udržujte tržby a počet zamestnancov aktuálne.
Rozhodnite o splatnosti, úverovom limite alebo zálohe na základe aktuálnych čísel.
Údaje o zákazníkovi a dodávateľovi automaticky do faktúry, zmluvy alebo žiadosti o úver.
Ako začať
- 1Napíšte nám
Opíšte spôsob použitia a očakávaný počet požiadaviek.
- 2Získajte testovací kľúč
Dokumentácia a kľúč na vyskúšanie so skutočnými údajmi.
- 3Dohodnite podmienky
Balík podľa objemu, faktúra na firmu.
Časté otázky
Odkiaľ pochádzajú údaje?
Z Registra právnických osôb (Štatistický úrad SR, CC BY 4.0), Registra účtovných závierok (CC0) a GLEIF (LEI). Údaje aktualizujeme denne podľa toho, ako ich zdroje zverejňujú.
Sú finančné údaje dostupné pre všetky firmy?
Pre väčšinu firiem áno. Výnimkou sú najväčšie spoločnosti, ktoré podávajú závierku podľa IFRS: tú RÚZ zverejňuje len ako PDF, takže čísla v štruktúrovanej podobe chýbajú.
Ako je to s osobnými údajmi?
O fyzických osobách poskytujeme len meno, funkciu, obdobie platnosti a vklad, ako sú uvedené vo verejnom registri. Adresy fyzických osôb, rodné čísla, dátumy narodenia, konečných užívateľov výhod ani vyhľadávanie osôb neposkytujeme.
Zvládne API veľké objemy?
Áno. Limity dohodneme podľa vášho objemu. Ak potrebujete celý register naraz, pozrite si aj hromadné vyhľadávanie a dataset.
Koľko to stojí?
Cena závisí od objemu a spôsobu použitia. Napíšte nám, na čo údaje potrebujete a v akom rozsahu, a pošleme vám ponuku.
Sú dostupné aj firmy z iných krajín?
Áno. Rovnaké riešenie je dostupné pre firmy v Estónsku (entity.ee), Lotyšsku (entity.lv), Dánsku (cvrprofil.dk) a Švédsku (bolagsprofil.se). Rozsah údajov závisí od otvorených dát každej krajiny. Viac krajín môže byť v jednej zmluve.
Máte záujem?
Napíšte nám, na čo údaje potrebujete a v akom rozsahu. Pošleme ponuku a odpovieme na otázky.