fetch-document
Endpunkte
GET

/v1/fetch-document

15 Credits • 5/min

Amtliche 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.