fetch-document
エンドポイント
GET

/v1/fetch-document

5クレジット • 5回/分

ドイツ商業登記から公式PDF文書をダウンロードします。

パラメータ

名前 タイプ 必須 説明
api_key string 条件付き* あなたのAPIキー。x-api-keyヘッダーまたはBearerトークンを使用していない場合は必須
company_id string 必須 検索結果からの一意の企業エンティティID
document_type string 必須 文書タイプ。値: shareholders_list, articles_of_association, AD, CD, SI

リクエスト例

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

レスポンス

成功 (200): PDFファイルを直接返します

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

エラー: エラーの詳細を含むJSONを返します

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.

文書タイプ

shareholders_list

株主登録簿文書

articles_of_association

Gesellschaftsvertrag / Satzung / Statut

AD

現在の抜粋(Aktuelle Daten)

CD

履歴抜粋(Chronologische Daten)

SI

Strukturierter Registerinhalt — wird als XML-Datei geliefert.