Veřejné API

REST API nad českými rejstříky

Data si držíme ve vlastní normalizované databázi, do které slučujeme registr ekonomických subjektů (ARES), obchodní rejstřík, insolvenční rejstřík a registr plátců DPH. Nejde tedy o průchozí volání cizího API — dotazy míří na naši databázi, takže jsou rychlé a nezávislé na dostupnosti zdrojových rejstříků. Odpovědi jsou JSON s konzistentní obálkou a povoleným CORS.

Obálka odpovědi

Úspěch vrací { "ok": true, "data": … }, chyba { "ok": false, "chyba": { "status", "zprava" } } se správným HTTP statusem (400, 404, 429, 502…).

Limity

Nepřihlášeným platí 30 dotazů denně na IP adresu (kalendářní den, čas Europe/Prague). Po vyčerpání vrací API 429 s hlavičkou Retry-After. Opakované pokusy po vyčerpání už spotřebu nezvyšují.

Stav limitu najdete v hlavičkách X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset u každé odpovědi — včetně chybových.

S účtem platí měsíční kvóta podle tarifu (Free 500 dotazů/měsíc) a žádný denní strop. Stačí účet zdarma. Bez limitu jsou našeptávač, /api/health a metadata pod /.well-known/.

Autentizace

API klíč si vydáte v účtu. Ukáže se jen jednou — držíme si z něj jen otisk, takže ho neumíme obnovit, jen vydat nový. Platí pro REST i MCP a čerpá jednu společnou kvótu účtu.

curl -H "Authorization: Bearer fs_vas_klic" \
  https://firmastat.cz/api/v1/firma/27082440

Klíč patří na server — z prohlížeče se autentizuje session cookie, MCP klienti přes OAuth.

Tarify

Tarif	Dotazů měsíčně	Řádků na export	Cena	Objednávka
Free	500	5 000	zdarma s účtem	Založit účet
Standard	50 000	20 000	990 Kč / měsíc	Mám zájem
Business	500 000	50 000	2 990 Kč / měsíc	Mám zájem
Enterprise	5 000 000	50 000	9 900 Kč / měsíc	Mám zájem

Běžný dotaz stojí jednu jednotku kvóty. Dávkový export /api/v1/vyhledavani/export se účtuje podle objemu — 100 řádků = jedna jednotka, účtuje se jen to, co reálně odteklo. Nepřihlášený má strop 1 000 řádků na export. Souběžně běží vždy jen jeden export na účet.

Potřebujete vyšší tarif nebo něco na míru?

Aktivaci i fakturaci zatím řešíme ručně e-mailem — ozveme se vám obvykle do druhého pracovního dne.

Mám zájem o Standard Mám zájem o Business Mám zájem o Enterprise

Chci vyšší tarif

Ceny jsou bez DPH. Platební bránu zatím nemáme — tarif vám aktivujeme ručně po domluvě na info@firmastat.cz.

GET/api/v1/firma/{ico}

Normalizovaný detail firmy (základ + obchodní rejstřík): jméno, sídlo, právní forma, CZ-NACE, spisová značka, základní kapitál, statutární orgány a společníci.

GET /api/v1/firma/27082440

GET/api/v1/firma/{ico}/export?format=csv

Export detailu firmy do CSV (oddělovač „;“, UTF-8 s BOM pro Excel).

GET /api/v1/firma/27082440/export?format=csv

GET/api/v1/osoby?q={jmeno}

Vyhledávání osob z obchodního rejstříku podle jména (na diakritice nezáleží). Vrací klíč profilu, počet firem a rok narození.

GET /api/v1/osoby?q=novak

GET/api/v1/osoba/{klic}

Profil osoby — firmy, ve kterých osoba figuruje, s rolí, obdobím a vkladem. Klíč (jmeno-prijmeni-rok-otisk) najdete u fyzických osob v detailu firmy; osoby se párují podle jména, příjmení a data narození z obchodního rejstříku.

GET /api/v1/osoba/jan-novak-1975-a3f9c2

GET/api/v1/vyhledavani

Vyhledávání firem. Parametry: q (název), kraj (RÚIAN kód), obec, forma (kód právní formy), nace (CZ-NACE), start, pocet (max 50). forma a nace lze zadat víckrát nebo oddělit čárkou.

GET /api/v1/vyhledavani?q=alza&kraj=19&forma=112

GET/api/v1/vyhledavani/export

Dávkový export výsledků vyhledávání do CSV (oddělovač „;“, UTF-8 s BOM pro Excel). Bere stejné filtry jako vyhledávání a vrací celý výsledek, ne jen jednu stránku. Odpověď se streamuje; strop řádků drží tarif (nepřihlášený 1 000, Free 5 000, Standard 20 000, Business a Enterprise 50 000) a účtuje se podle objemu. Zkrácení hlásí hlavička X-Firmastat-Zkraceno i název souboru, cenu v jednotkách kvóty hlavička X-Firmastat-Jednotek.

GET /api/v1/vyhledavani/export?kraj=116&forma=112&nace=62

GET/api/suggest?q={dotaz}

Našeptávač pro vyhledávací pole — vrací do 8 návrhů (název, IČO, sídlo). Pomocné rozhraní pro UI, vrací prosté pole bez obálky.

GET /api/suggest?q=alza

Zdroje dat: registr ekonomických subjektů ARES (ČSÚ / Ministerstvo financí ČR), obchodní rejstřík a Sbírka listin (justice.cz), insolvenční rejstřík ISIR a registr plátců DPH (MFČR). Údaje mají informativní charakter; závazné jsou vždy zdrojové rejstříky.