Veřejné API

REST API nad daty z ARES

Firmastat nabízí jednoduché veřejné REST API nad normalizovanými daty z ARES. Odpovědi jsou ve formátu JSON s konzistentní obálkou a mají povolené CORS pro čtení z prohlížeče. Data mají informativní charakter.

Obálka odpovědi

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

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/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/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

Zdroj dat: ARES (Ministerstvo financí ČR). Respektujte prosím rozumnou frekvenci dotazů; API funguje jako tenká vrstva nad ARES.