Dokumenty
Jaké dokumenty existují a v jakém formátu.
Pomocí fetch-document stáhneš úřední dokumenty z rejstříku jako soubor. Předej entity_id firmy v company_id a zvol document_type. Každý doručený dokument stojí 15 kreditů.
Typy dokumentů
Existuje pět typů dokumentů. Hodnoty pro document_type piš přesně jako v tabulce, včetně velkých a malých písmen. Ukázkový požadavek načítá Aktueller Abdruck Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Dokument | Formát |
|---|---|---|
| AD | Aktueller Abdruck (aktuální výpis)Všechny dnes platné zápisy. Klasický výpis z rejstříku. | |
| CD | Chronologischer Abdruck (chronologický výpis)Všechny zápisy v chronologickém pořadí, včetně vymazaných, od doby, kdy se rejstřík vede elektronicky. | |
| SI | Strukturierter Registerinhalt (strukturovaný obsah rejstříku)Obsah rejstříku jako XML ve standardu XJustiz, vhodný pro strojové zpracování. | XML |
| shareholders_list | Gesellschafterliste (seznam společníků)Seznam společníků s jejich podíly, jak ho GmbH podává do rejstříku. | |
| articles_of_association | Gesellschaftsvertrag nebo Satzung (společenská smlouva nebo stanovy)Smlouva, která upravuje firmu. U GmbH se jmenuje Gesellschaftsvertrag, u AG a eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: TVUJ_API_KLIC" \ --data-urlencode 'company_id=94eb910fef13f94585c48c263fa446d4' \ --data-urlencode 'document_type=AD'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-document", headers={"x-api-key": "TVUJ_API_KLIC"}, params={ "company_id": "94eb910fef13f94585c48c263fa446d4", "document_type": "AD", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-document"); url.searchParams.append("company_id", "94eb910fef13f94585c48c263fa446d4"); url.searchParams.append("document_type", "AD"); const response = await fetch(url, { headers: { "x-api-key": "TVUJ_API_KLIC" }, }); const data = await response.json();
Dokumenty podle právní formy
Aktueller Abdruck, Chronologischer Abdruck a Strukturierter Registerinhalt existují pro každou zapsanou firmu. Jaké podané dokumenty existují nad rámec toho, závisí na právní formě.
| Právní forma | AD, CD, SI | Seznam společníků | Společenská smlouva |
|---|---|---|---|
| GmbH, UG | ano | ano, povinně | ano, Gesellschaftsvertrag |
| AG, SE, KGaA | ano | ne | ano, Satzung |
| eG | ano | ne | ano, Satzung |
| KG, GmbH & Co. KG, OHG | ano | ne | většinou ne |
| PartG, PartG mbB | ano | ne | většinou ne |
| e.K. | ano | ne | většinou ne |
Seznam společníků existuje jen pro GmbH a UG. U jiných právních forem a chybějících dokumentů API odpoví 404 a nic neúčtuje.
Formáty
Odpovědí je samotný soubor, ne JSON. Typ poznáš podle headeru Content-Type, název souboru podle headeru Content-Disposition.
Název souboru obsahuje entity_id, typ dokumentu a datum načtení, např. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Seznamy společníků a smlouvy jsou často naskenované stránky, některé bez textové vrstvy. Pro získání textu pak potřebuješ OCR.
Některé dokumenty jsou v rejstříku k dispozici jen jako obrázek TIFF. API pak odpoví 415 a nic neúčtuje.
V našem příkladu Hetzner Online GmbH měly soubory tyto velikosti: Aktueller Abdruck asi 35 KB, Strukturierter Registerinhalt asi 14 KB, Gesellschaftsvertrag asi 450 KB.
async=true. Pokud rejstřík neodpoví včas, dostaneš 504 s Retry-After. Nic se pak neúčtuje.