Prvé volanie za minútu
Kľúč dostanete po aktivácii plánu. Posielate ho v hlavičke Authorization:
curl -H "Authorization: Bearer sd_live_…" \
https://slovakdata.sk/api/v1/firma/31320155API kľúč
Kľúč má tvar sd_live_ a 40 znakov. Pošlite ho v hlavičke Authorization: Bearer … alebo x-api-key.
Kľúč je dôverný a viazaný na váš plán — nezdieľajte ho a nevkladajte ho do kódu, ktorý beží v prehliadači. Ak unikne, napíšte nám a vydáme nový.
Profil firmy podľa IČO
/api/v1/firma/{ico}Profil firmy — základné údaje, financie zo závierok, vedenie a vlastníci; v pláne Expert a v licencii Firma aj riziká (konkurzy, dlhy na poistnom, záložné práva, dane). Štruktúra zodpovedá profilu na webe, pole vrstvy hovorí, čo váš plán obsahuje. Započíta sa 1 záznam.
{
"ico": "31320155",
"profil": {
"osoba_href": null,
"kontakty_info": null,
"kontakty_zakazane": false,
"kontakty_potvrdene": null,
"zmeny": [
{
"druh": "adresa",
"hodnota": "Kellerova 74 Bardejov",
"platne_od": "1992-08-12T00:00:00.000Z",
"platne_do": "1999-07-06T00:00:00.000Z"
},
{
"druh": "adresa",
"hodnota": "Banícka 307/4 Modrý Kameň",
"platne_od": "1992-08-21T00:00:00.000Z",
"platne_do": "1996-10-20T00:00:00.000Z"
},
{
"druh": "adresa",
"hodnota": "Novohradská 7 Veľký Krtíš",
"platne_od": "1996-10-21T00:00:00.000Z",
"platne_do": "2003-08-19T00:00:00.000Z"
},
{
"druh": "adresa",
"hodnota": "Mlynské nivy 1 Bratislava",
"platne_od": "1999-10-18T00:00:00.000Z",
"platne_do": null
},
{
"druh": "forma",
"hodnota": "Akciová spoločnosť",
"platne_od": "1992-03-25T00:00:00.000Z",
"platne_do": null
},
{
"druh": "forma",
"hodnota": "Akciová spoločnosť",
"platne_od": "1992-08-12T00:00:00.000Z",
"platne_do": null
},
{
"druh": "forma",
"hodnota": "Akciová spoločnosť",
"platne_od": "1992-08-21T00:00:00.000Z",
"platne_do": null
},
{
"druh": "nazov",
"hodnota": "Všeobecná úverová banka, a.s.; skrátený názov: VÚB, a.s.",
"platne_od": "1992-03-25T00:00:00.000Z",
"platne_do": null
},
{
"druh": "nazov",
"hodnota": "Všeobecná úverová banka a.s. Bratislava, pobočka Bardejov",
"platne_od": "1992-08-12T00:00:00.000Z",
…Vyhľadávanie firiem
/api/v1/hladanieFirmy podľa názvu a filtrov, 50 na stranu, najviac 20 strán. Započíta sa každá vrátená firma.
| Parameter | Popis |
|---|---|
| q | názov firmy, IČO alebo časť názvu |
| obec | sídlo, napr. Bratislava |
| okres | kód okresu |
| nace | kód SK NACE, napr. 62010 |
| forma |
Využitie kľúča
/api/v1/vyuzitieMesačný objem, koľko ste využili a kedy sa obnoví. Nezapočítava sa.
{ "plan": "profi", "mesacny_limit": 10000, "vyuzite": 1240, "zostava": 8760, "obnovenie": "2026-11-01" }Objem a rýchlosť
Meria sa počet záznamov, nie volaní: profil firmy = 1 záznam, hľadanie = počet vrátených firiem. Plán Profesionál obsahuje 10 000 záznamov mesačne, Expert 25 000, licencia Firma objem podľa zmluvy. Objem sa obnovuje 1. dňa v mesiaci.
Najviac 600 požiadaviek za minútu na kľúč. Každá odpoveď nesie hlavičky X-Limit-Mesacny, X-Vyuzite a X-Zostava.
Kódy odpovedí
| Kód | Význam |
|---|---|
| 200 | v poriadku |
| 400 | neplatný parameter, napr. IČO kratšie ako 6 číslic |
| 401 | chýba alebo je neplatný API kľúč |
| 404 | firma s týmto IČO v registri nie je |
| 429 | vyčerpaný mesačný objem alebo príliš veľa požiadaviek |
| 502 | dočasná chyba, skúste znova |
Chyba má tvar { "chyba": "…", "dokumentacia": "…" }.
Použitie údajov
Údaje z API smiete použiť pre vlastnú vnútornú potrebu podľa článku 8 podmienok používania — nie na ďalší predaj, zverejnenie ani budovanie konkurenčnej databázy. Odpovede sú označené a volania evidované.
Pripravení začať?
API je súčasťou plánov Profesionál a Expert. Kľúč vydáme do 24 hodín od úhrady.
Pozrieť plány