fetch-document
Endpoints
GET

/v1/fetch-document

15 crédits • 5/min

Télécharge des documents PDF officiels du registre commercial allemand.

Paramètres

Nom Type Requis Description
api_key string Conditionnel* Votre clé API. Requise si vous n'utilisez pas l'en-tête x-api-key ou le token Bearer
company_id string REQUIS ID unique d'entité d'entreprise des résultats de recherche
document_type string REQUIS Type de document. Valeurs : shareholders_list, articles_of_association, AD, CD, SI

Exemple de Requête

curl 'https://handelsregister.ai/api/v1/fetch-document?api_key=your_api_key_here&company_id=20a1510e88cd2e9b166db4d0bc5d563d&document_type=shareholders_list' \
  -o document.pdf

Réponse

Succès (200) : Retourne le fichier PDF directement

Content-Type : application/pdf · application/xml (application/pdf für AD, CD, shareholders_list, articles_of_association — application/xml für SI.)

Erreur : Retourne JSON avec détails de l'erreur

504 Antwortet das Handelsregister nicht rechtzeitig, liefert die API 504 mit Retry-After-Header. Das Dokument kann trotzdem existieren: Wiederhole den Abruf frühestens nach 60 Sekunden, mit wachsendem Abstand (z. B. 1, dann 5 Minuten). Fehlgeschlagene Abrufe kosten keine Credits. 404 bedeutet: Das Dokument ist für diese Firma nicht verfügbar.

Types de Document

shareholders_list

Document de registre des actionnaires

articles_of_association

Gesellschaftsvertrag / Satzung / Statut

AD

Extraits actuels (Aktuelle Daten)

CD

Extraits historiques (Chronologische Daten)

SI

Strukturierter Registerinhalt — wird als XML-Datei geliefert.