Dokumentumok
Milyen dokumentumok vannak, és milyen formátumban.
A fetch-document révén hivatalos dokumentumokat töltesz le a nyilvántartásból fájlként. Add meg a cég entity_id-ját a company_id paraméterben, és válassz egy document_type értéket. Minden kiszállított dokumentum 15 kredit kerül.
Dokumentumtípusok
Öt dokumentumtípus van. A document_type értékeit pontosan úgy írd, ahogy a táblázatban állnak, a kis- és nagybetűket is beleértve. A példakérés a Hetzner Online GmbH (Ansbach HRB 6089) Aktueller Abdruck dokumentumát kéri le.
| document_type | Dokumentum | Formátum |
|---|---|---|
| AD | Aktueller Abdruck (aktuális kivonat)A ma érvényes összes bejegyzés. A klasszikus cégkivonat. | |
| CD | Chronologischer Abdruck (kronologikus kivonat)Az összes bejegyzés időrendben, a töröltekkel együtt, amióta a nyilvántartást elektronikusan vezetik. | |
| SI | Strukturierter Registerinhalt (strukturált nyilvántartási tartalom)A nyilvántartás tartalma XML-ként, XJustiz szabvány szerint, gépi feldolgozásra alkalmas. | XML |
| shareholders_list | Gesellschafterliste (tagjegyzék)A tagjegyzék az üzletrészekkel, ahogy a GmbH benyújtja a nyilvántartásnak. | |
| articles_of_association | Gesellschaftsvertrag vagy Satzung (társasági szerződés, alapszabály)A céget szabályozó szerződés. GmbH-nál Gesellschaftsvertrag, AG-nál és eG-nél Satzung a neve. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: AZ_API_KULCSOD" \ --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": "AZ_API_KULCSOD"}, 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": "AZ_API_KULCSOD" }, }); const data = await response.json();
Dokumentumok jogi formánként
Aktueller Abdruck, Chronologischer Abdruck és Strukturierter Registerinhalt minden bejegyzett céghez létezik. Hogy ezen túl milyen benyújtott dokumentumok vannak, az a jogi formától függ.
| Jogi forma | AD, CD, SI | Tagjegyzék | Társasági szerződés |
|---|---|---|---|
| GmbH, UG | igen | igen, kötelező | igen, a Gesellschaftsvertrag |
| AG, SE, KGaA | igen | nem | igen, a Satzung |
| eG | igen | nem | igen, a Satzung |
| KG, GmbH & Co. KG, OHG | igen | nem | általában nem |
| PartG, PartG mbB | igen | nem | általában nem |
| e.K. | igen | nem | általában nem |
Tagjegyzék csak GmbH-hoz és UG-hoz létezik. Más jogi formáknál és hiányzó dokumentumoknál az API 404-gyel válaszol, és semmit nem számol fel.
Formátumok
A válasz maga a fájl, nem JSON. A típust a Content-Type, a fájlnevet a Content-Disposition header alapján ismered fel.
A fájlnév tartalmazza az entity_id-t, a dokumentumtípust és a lekérés dátumát, pl. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
A tagjegyzékek és a társasági szerződések gyakran szkennelt oldalak, némelyik szöveges réteg nélkül. A szöveghez ilyenkor OCR kell.
Egyes dokumentumok a nyilvántartásból csak TIFF-képként érhetők el. Az API ilyenkor 415-tel válaszol, és semmit nem számol fel.
A Hetzner Online GmbH példájában a fájlok mérete ez volt: Aktueller Abdruck kb. 35 KB, Strukturierter Registerinhalt kb. 14 KB, Gesellschaftsvertrag kb. 450 KB.
async=true paraméterrel. Ha a nyilvántartás nem válaszol időben, 504-et kapsz Retry-After headerrel. Ilyenkor semmit nem számolunk fel.