/v1/fetch-document
15 Credits • 5/minAmtliche Dokumente aus dem deutschen Handelsregister herunterladen — PDF oder XML, je nach Dokumenttyp.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| api_key | string | Bedingt* | Dein API-Key. Nur erforderlich, wenn Du weder den x-api-key-Header noch ein Bearer-Token verwendest. |
| company_id | string | ERFORDERLICH | Die entity_id des Unternehmens, z. B. aus den Suchergebnissen. |
| document_type | string | ERFORDERLICH | Dokumenttyp. Werte: shareholders_list, articles_of_association, AD, CD, SI |
Beispiel-Anfrage
curl 'https://handelsregister.ai/api/v1/fetch-document?api_key=your_api_key_here&company_id=20a1510e88cd2e9b166db4d0bc5d563d&document_type=shareholders_list' \
-o document.pdf
Antwort
Erfolg (200): Liefert das Dokument direkt als Datei — PDF für AD, CD, shareholders_list und articles_of_association, XML für SI.
Content-Type: application/pdf · application/xml (application/pdf für AD, CD, shareholders_list, articles_of_association — application/xml für SI.)
Fehler: Liefert JSON mit den Fehlerdetails.
Dokumenttypen
shareholders_list
Gesellschafterliste
articles_of_association
Gesellschaftsvertrag / Satzung / Statut
AD
Aktueller Registerauszug (Aktuelle Daten)
CD
Chronologischer Registerauszug (Chronologische Daten)
SI
Strukturierter Registerinhalt — wird als XML-Datei geliefert.