API referencia

Údaje firmy podľa IČO cez API

GET /v1/entity/{ico}: názov, sídlo, DIČ, IČ DPH a ďalšie dostupné údaje firmy zo Slovenska alebo Česka v jednej JSON odpovedi.

Vyskúšaj tento endpoint 
{ "stav": "pripravený" }

Kompletný detail firmy podľa IČO. Vracia všetky dostupné polia vrátane právnej formy, dátumu vzniku a zániku, registračných údajov a zdrojových metadát.

curl "https://api.subjekt.sk/v1/entity/31322832?country=sk"

Parametre

Parameter Typ Povinný Popis
ico string (path) áno IČO firmy — presne 8 číslic
country string nie Krajina: sk alebo cz. Ak nie je zadaná, API najprv skúsi SK, potom CZ.

Odpoveď (200)

{
  "ico": "31322832",
  "name": "SLOVNAFT, a.s.",
  "address": {
    "street": "Vlčie hrdlo",
    "building_no": "1",
    "city": "Bratislava",
    "zip": "82412",
    "country": "SK"
  },
  "legal_form": "Akciová spoločnosť",
  "legal_form_code": "121",
  "dic": "2020372640",
  "ic_dph": "SK7120001713",
  "established": "1992-05-01",
  "terminated": null,
  "registration": {
    "office": "Mestský súd Bratislava III",
    "number": "Sa/426/B"
  },
  "source": "subjekt.sk",
  "updated_at": "2026-03-24",
  "source_country": "sk",
  "source_system": "rpo",
  "dic_source_system": "fs",
  "source_license_class": "cc_by_4_0",
  "source_terms_url": "https://susrrpo.docs.apiary.io/"
}

Popis všetkých polí nájdete v schémach odpovedí.

Chyba (404)

{
  "code": "not_found",
  "message": "No entity found with ICO 12345670",
  "request_id": "f94251a8-f011-4a98-bf7c-5f1fc45f4abc"
}

Poznámky k správaniu

  • Ak parameter country nie je zadaný, API najprv hľadá v SK databáze. Ak nenájde, automaticky skúsi CZ (ARES proxy).
  • Pri country=sk a nenájdenej firme vráti 404 not_found bez prístupu na ARES.
  • Pri country=cz sa upstream 5xx ARES mapuje na 502 upstream_unavailable a timeout na 504 timeout.
  • Pole terminated obsahuje dátum zániku evidovaný v zdroji; null znamená, že v dostupnom zázname dátum zániku nie je. Zohľadnite aktuálnosť dát.
  • 404 znamená nenájdený záznam v službe, nie dôkaz neexistencie firmy.
  • Pole legal_form_code je dostupné iba pre SK entity; pre CZ je vždy null.
  • CZ dáta sú informatívne, pozri Prehľad. Limity a hlavičky sú na stránke Rate limity.

Návody na integráciu

Táto stránka vo formáte Markdown