Dokumenty
Jakie dokumenty istnieją i w jakim formacie.
Przez fetch-document pobierasz urzędowe dokumenty z rejestru jako plik. Przekaż entity_id firmy w company_id i wybierz document_type. Każdy dostarczony dokument kosztuje 15 kredytów.
Typy dokumentów
Jest pięć typów dokumentów. Wartości dla document_type zapisuj dokładnie jak w tabeli, z zachowaniem wielkości liter. Przykładowe zapytanie pobiera Aktueller Abdruck Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Dokument | Format |
|---|---|---|
| AD | Aktueller Abdruck (odpis aktualny)Wszystkie wpisy obowiązujące dziś. Klasyczny odpis z rejestru. | |
| CD | Chronologischer Abdruck (odpis chronologiczny)Wszystkie wpisy w kolejności chronologicznej, także wykreślone, od kiedy rejestr jest prowadzony elektronicznie. | |
| SI | Strukturierter Registerinhalt (ustrukturyzowana treść rejestru)Treść rejestru jako XML w standardzie XJustiz, dobra do przetwarzania maszynowego. | XML |
| shareholders_list | Gesellschafterliste (lista wspólników)Lista wspólników z ich udziałami, tak jak GmbH składa ją do rejestru. | |
| articles_of_association | Gesellschaftsvertrag lub Satzung (umowa spółki lub statut)Umowa regulująca firmę. W GmbH nazywa się Gesellschaftsvertrag, w AG i eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); const data = await response.json();
Dokumenty według formy prawnej
Aktueller Abdruck, Chronologischer Abdruck i Strukturierter Registerinhalt istnieją dla każdej zarejestrowanej firmy. Jakie złożone dokumenty istnieją poza tym, zależy od formy prawnej.
| Forma prawna | AD, CD, SI | Lista wspólników | Umowa spółki |
|---|---|---|---|
| GmbH, UG | tak | tak, obowiązkowo | tak, Gesellschaftsvertrag |
| AG, SE, KGaA | tak | nie | tak, Satzung |
| eG | tak | nie | tak, Satzung |
| KG, GmbH & Co. KG, OHG | tak | nie | zwykle nie |
| PartG, PartG mbB | tak | nie | zwykle nie |
| e.K. | tak | nie | zwykle nie |
Lista wspólników istnieje tylko dla GmbH i UG. Dla innych form prawnych i brakujących dokumentów API odpowiada 404 i nic nie nalicza.
Formaty
Odpowiedź to sam plik, nie JSON. Typ rozpoznasz po nagłówku Content-Type, nazwę pliku po nagłówku Content-Disposition.
Nazwa pliku zawiera entity_id, typ dokumentu i datę pobrania, np. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Listy wspólników i umowy to często zeskanowane strony, czasem bez warstwy tekstowej. Aby uzyskać tekst, potrzebujesz wtedy OCR.
Niektóre dokumenty rejestr udostępnia tylko jako obraz TIFF. API odpowiada wtedy 415 i nic nie nalicza.
W naszym przykładzie Hetzner Online GmbH pliki miały takie rozmiary: Aktueller Abdruck ok. 35 KB, Strukturierter Registerinhalt ok. 14 KB, Gesellschaftsvertrag ok. 450 KB.
async=true. Jeśli rejestr nie odpowie na czas, dostajesz 504 z Retry-After. Nic nie jest wtedy naliczane.