Přihlášení klíčem
Klíč vytvoříte v účtu; ukáže se jen jednou
Každý požadavek nese klíč v hlavičce Authorization: Bearer cd_…. Klíče spravujete v účtu; uchováváme jen jejich otisk.
curl -H "Authorization: Bearer cd_VÁŠ_KLÍČ" https://ceskadata.cz/api/v1/firma/27082440
Endpointy
- GET /api/v1/firma/{ico}
- Jedna firma s vrstvami vašeho plánu. 1 záznam. Neznámé IČO (404) se nepočítá.
- GET /api/v1/hledani
- Filtry jako ve vyhledávání:
q(název nebo IČO),obec,okres(kód LAU),nace(kódy oddělené čárkou),forma,katpo,aktivni=falsei se zaniklými;limitdo 100,stranaod 1. Kolik firem vrátí, tolik záznamů. - GET /api/v1/vyuziti
- Plán a zbývající záznamy v tomto měsíci. Zdarma.
{
"firma": { "ico": "27082440", "nazev": "Alza.cz a.s.", "zamestnanci": "…", "statutari": "…" },
"vyuziti": { "plan": "Profesionál", "zaznamu_mesicne": 10000, "vycerpano": 1, "zbyva": 9999, "obdobi_do": "…" }
}Chyby: 400 špatný dotaz, 401 klíč, 402 plán bez API, 404 neznámé IČO, 429 vyčerpaný měsíc nebo víc než 300 požadavků za minutu. Fyzické osoby podnikající API nevydává.
Co záznam obsahuje
Stejné vrstvy jako export – podle plánu
Základní údaje · od plánu Zdarma
ico ičonazev názevforma právní formaadresa adresaobec obecpsc psčokres okreskraj krajnace cz-naceobor hlavní činnostvznik datum vznikustav stavzanik datum zániku
Velikost a postavení · od plánu Start
zamestnanci zaměstnanci (pásmo čsú)sektor institucionální sektorlet_na_trhu let na trhumensich_v_oboru menších firem v oboru a obcifirem_v_oboru firem v oboru a obci s uvedenou velikostípreziti_rocniku přežití ročníku v oboru (%)firem_na_adrese dalších firem na adrese
Vedení a vlastníci · od plánu Profesionál
statutari statutární orgánpocet_statutaru počet statutárůspolecnici společníci a podílypocet_spolecniku počet společníkůkapital základní kapitál (kč)
Aktivita a rizika · od plánu Expert
nespolehlivy_platce nespolehlivý plátce dph odkontroly_coi kontroly čoipokuty_coi pokuty čoi (počet)pokuty_coi_kc pokuty čoi (kč)zakazky vyhrané veřejné zakázkyzakazky_kc hodnota zakázek (kč)volna_mista volná místamzda nabízená mzda (kč)vozidla vozidla v provozustari_vozidel průměrné stáří vozidel (roky)
Objem podle plánu
- Profesionál25 údajů o firmě10 000 záznamů / měs.
- Expert35 údajů o firmě25 000 záznamů / měs.