Přeskočit na obsah
ARES.CZ Vyhledávání ekonomických subjektů

API veřejných registrů pro vývojáře

Aktualizováno: · Autor:

Údaje o českých a slovenských firmách můžete do své aplikace načítat zdarma přímo ze státních registrů. ARES vrací identifikační údaje firem a OSVČ přes REST API v JSON, registr plátců DPH (ADISREG) ověří plátce a jeho bankovní účty, VIES zkontroluje DIČ v celé EU a insolvenční rejstřík (ISIR) prozradí insolvence. Průvodce vychází ze zkušeností z provozu ARES.CZ, který tato rozhraní volá denně: co které API umí, jaké má limity, na co si dát pozor a kdy je lepší stáhnout otevřená data.

Návody a nástroje

ARES API — kompletní návod

Endpointy, ukázky v curl, PHP, Pythonu a JavaScriptu, chybové kódy, limity, hlídání změn a převod ze starého XML ARES.

Vyzkoušet ARES API živě

Zadejte IČO a uvidíte skutečnou odpověď ARES v JSON, dobu odezvy a příkaz curl. Dotaz jde z vašeho prohlížeče přímo do ARES.

Přehled veřejných API českých a slovenských registrů

Tabulka shrnuje rozhraní, se kterými máme vlastní zkušenost z provozu. Limity uvádíme podle podmínek provozovatele; kde provozovatel číslo nezveřejňuje, píšeme, jak se rozhraní chová při přetížení. Stav k 2. října 2026.

RegistrProvozovatelCo vracíRozhraníPřístupLimit
ARES Ministerstvo financí ČR identifikační údaje firem a OSVČ z více než deseti registrů, statutáři a společníci (pohled VR), živnosti (RŽP), statistické údaje (RES) REST, JSON, OpenAPI zdarma, bez klíče 500 dotazů/min
Registr plátců DPH (ADISREG) Finanční správa ČR plátce DPH, nespolehlivý plátce a od kdy, zveřejněné bankovní účty SOAP, WSDL zdarma, bez klíče nezveřejněn
VIES Evropská komise platnost DIČ v EU; u většiny zemí i název a adresa (Německo, Španělsko, Itálie a Nizozemsko je nevracejí) REST, JSON (i SOAP), dokumentace zdarma, bez klíče nezveřejněn; při přetížení chyba MS_MAX_CONCURRENT_REQ
Insolvenční rejstřík (ISIR) Ministerstvo spravedlnosti insolvenční řízení podle IČO nebo jména a data narození, spisová značka, stav řízení REST (e-ISIR) a SOAP IsirWsCuzkService na portu 8443, dokumentace zdarma, bez klíče 3 000/den, 50/min
Centrální evidence exekucí (CEE) Exekutorská komora ČR probíhající exekuce podle IČO právnické osoby nebo jména a data narození REST API v4, dokumentace placené, klíč vázaný na IP adresu poplatek za každý údaj (vyhl. č. 329/2008 Sb.)
Veřejný rejstřík — otevřená data Ministerstvo spravedlnosti hromadné výpisy z obchodního, spolkového a dalších rejstříků po soudech a právních formách XML a CSV ke stažení, katalog s API zdarma —
Registr ekonomických subjektů — otevřená data Český statistický úřad všechny ekonomické subjekty: IČO, právní forma, CZ-NACE, kategorie počtu zaměstnanců, adresa CSV (přes 500 MB), datová sada zdarma —
RPO (Slovensko) Štatistický úrad SR slovenské právnické osoby a podnikatelé včetně historie názvů a sídel REST, JSON, dokumentace zdarma, bez klíče nezveřejněn; při rychlém dotazování HTTP 429
RegisterUZ (Slovensko) Ministerstvo financií SR účtovné jednotky a jejich účtovné závierky REST, JSON, dokumentace zdarma, bez klíče nezveřejněn
Obchodný register SR (ORSR) Ministerstvo spravodlivosti SR slovenský obchodní rejstřík bez API, jen webové stránky — —

Všechny odkazy vedou na oficiální dokumentaci provozovatelů. ARES.CZ není provozovatelem žádného z těchto rozhraní.

API, nebo otevřená data?

API se hodí, když potřebujete aktuální údaje o jednotlivých firmách — typicky předvyplnění odběratele na faktuře podle IČO, kontrolu dodavatele před platbou nebo ověření DIČ zákazníka z EU. Odpověď přijde za zlomek sekundy a vždy odráží aktuální stav registru.

Otevřená data zvolte, když potřebujete velké množství záznamů najednou: analýzu trhu, seznam firem v oboru nebo regionu, párování vlastní databáze. Procházet celý registr po jednom IČO přes API je pomalé a podmínky provozu ARES to přímo zakazují (prohledávání databáze náhodnými údaji). Hromadně nabízí data dva zdroje:

  • Registr ekonomických subjektů ČSÚ — jeden CSV soubor se všemi subjekty (IČO, název, právní forma, CZ-NACE, kategorie počtu zaměstnanců, adresa). Ideální základ pro vlastní vyhledávání nebo analýzy.
  • Otevřená data veřejného rejstříku na dataor.justice.cz — úplné i aktuální výpisy podle rejstříkových soudů a právních forem (s.r.o., a.s., spolky a další), včetně statutárních orgánů.

Samotný ARES hromadný soubor nenabízí: v katalogu otevřených dat Ministerstva financí je ARES veden jako datová sada bez souboru ke stažení a data poskytuje jen přes API. Osvědčená kombinace je proto hromadný základ z otevřených dat + API pro čerstvé údaje o firmách, se kterými právě pracujete. Na změny upozorní notifikační dávky ARES.

Pravidla slušného klienta

Státní registry běží na sdílené infrastruktuře a jejich provozovatelé mohou přístup omezit nebo zablokovat. Obnovení po zablokování bývá zdlouhavé (u ARES jen na základě písemných záruk), proto se vyplatí od začátku dodržet pár zásad:

  1. Cachujte. Identifikační údaje firmy se mění zřídka. Uložte odpověď na hodiny až dny a stejný dotaz neposílejte znovu — opakování stejných dotazů je v podmínkách ARES výslovně uvedeno jako důvod k omezení.
  2. Držte rezervu pod limitem. ARES omezí uživatele nad 500 dotazů za minutu. Plánujte s polovinou a nezapomeňte, že ze sdílené IP adresy (sdílený hosting, firemní NAT) se dotazy všech sčítají.
  3. Neposílejte nesmysly. Ověřte formát vstupu ještě před dotazem — IČO má 8 číslic a kontrolní součet, DIČ v EU má pro každou zemi pevný formát. Opakované chybné dotazy jsou dalším důvodem k omezení.
  4. Dávkujte. ARES vrátí až 100 subjektů jedním dotazem POST /ekonomicke-subjekty/vyhledat s polem IČO — jeden dotaz místo sta.
  5. Při chybě zpomalte. Na odpovědi 5xx, timeout nebo HTTP 429 reagujte čekáním, které se s každým pokusem prodlužuje (exponential backoff), a po pár neúspěších přestaňte. VIES navíc hlásí výpadky jednotlivých zemí jako chybu v těle odpovědi, ne HTTP kódem.
  6. Nerozkládejte provoz na více IP adres. Obcházení limitu z více adres podmínky ARES zakazují stejně jako bezpečnostní útoky.

Časté otázky k API registrů

Má ARES.CZ vlastní API?

Nemá. ARES.CZ je webová aplikace postavená nad veřejnými API státních registrů a strojový přístup k vlastním datům nenabízí. Pro aplikaci volejte přímo oficiální rozhraní — návody, ukázky kódu a limity najdete v tomto průvodci. Pro ruční ověření firmy stačí vyhledávání na ARES.CZ.

Jsou API státních registrů zdarma a potřebuji klíč?

ARES, registr plátců DPH (ADISREG), VIES, insolvenční rejstřík (ISIR) i slovenské RPO a RegisterUZ jsou zdarma, bez registrace a bez klíče. Placená je Centrální evidence exekucí — API s klíčem a poplatkem za každý údaj podle vyhlášky č. 329/2008 Sb.

Jaké limity dotazů platí?

ARES omezí uživatele, který pošle víc než 500 dotazů za minutu; denní strop nemá. Insolvenční rejstřík dovolí 3 000 dotazů denně a 50 za minutu. VIES a ADISREG pevné číslo nezveřejňují, při přetížení ale dotazy odmítají. U všech platí: výsledky ukládejte do cache a neposílejte opakovaně stejné dotazy.

Kde stáhnu hromadná data o všech firmách?

ARES hromadný soubor nenabízí, data poskytuje jen přes API. Celý registr ekonomických subjektů (IČO, právní forma, CZ-NACE, kategorie počtu zaměstnanců, adresa) zveřejňuje Český statistický úřad jako otevřená data v CSV; výpisy z veřejného rejstříku po soudech a právních formách nabízí Ministerstvo spravedlnosti na dataor.justice.cz.

Související nástroje a zdroje

Nechcete programovat? Stejná data najdete na ARES.CZ bez registrace:

Oficiální zdroje: ARES — informace pro vývojáře  ·  Ministerstvo financí — otevřená data a API ARES  ·  Národní katalog otevřených dat

Nejznámější firmy v ARES.CZ