書類

どの書類があり、どの形式か。

fetch-documentを使うと、登記簿の公式書類をファイルとしてダウンロードできます。企業のentity_idをcompany_idで渡し、document_typeを選びます。提供された書類は1件 15 クレジットです。

書類の種類

書類の種類は5つあります。document_typeの値は、大文字・小文字も含めて表のとおり正確に書いてください。例のリクエストでは、Hetzner Online GmbH（Ansbach HRB 6089）の現在事項抄本を取得しています。

document_type
document_type	書類	形式
AD	現在事項抄本（Aktueller Abdruck）現在有効なすべての登記。典型的な登記簿抄本です。	PDF
CD	履歴抄本（Chronologischer Abdruck）登記簿が電子的に管理されるようになって以降の、抹消されたものも含むすべての登記を時系列で。	PDF
SI	構造化された登記内容（Strukturierter Registerinhalt）XJustiz標準のXMLによる登記内容。機械処理に向いています。	XML
shareholders_list	株主名簿（Gesellschafterliste）GmbHが登記簿に提出する、持分付きの株主名簿。	PDF
articles_of_association	定款（GesellschaftsvertragまたはSatzung）企業を規律する契約。GmbHではGesellschaftsvertrag、AGとeGではSatzungと呼ばれます。	PDF

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --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": "YOUR_API_KEY"},
    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": "YOUR_API_KEY" },
});
const data = await response.json();

法的形態ごとの書類

現在事項抄本、履歴抄本、構造化された登記内容は、登記されているすべての企業にあります。それ以外にどの提出書類があるかは、法的形態によります。

法的形態
法的形態	AD、CD、SI	株主名簿	定款
GmbH, UG	あり	あり、義務	あり、Gesellschaftsvertrag
AG, SE, KGaA	あり	なし	あり、Satzung
eG	あり	なし	あり、Satzung
KG, GmbH & Co. KG, OHG	あり	なし	通常はなし
PartG, PartG mbB	あり	なし	通常はなし
e.K.	あり	なし	通常はなし

株主名簿があるのはGmbHとUGだけです。その他の法的形態や存在しない書類には、APIは404を返し、何も課金しません。

形式

レスポンスはJSONではなく、ファイルそのものです。種類はContent-Typeヘッダーで、ファイル名はContent-Dispositionヘッダーでわかります。

ファイル名にはentity_id、書類の種類、取得日が含まれます。例：document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf。

株主名簿と定款はスキャンしたページであることが多く、テキストレイヤーのないものもあります。その場合テキストを得るにはOCRが必要です。

一部の書類は登記簿からTIFF画像でしか入手できません。その場合APIは415を返し、何も課金しません。

Hetzner Online GmbHの例では、ファイルの大きさは次のとおりでした：現在事項抄本は約35 KB、構造化された登記内容は約14 KB、Gesellschaftsvertragは約450 KB。

書類は必要に応じて登記簿から直接取得します。これには最大2分かかることがあります。そのため、クライアントのタイムアウトを120秒以上に設定するか、async=trueでバックグラウンドで書類を取得してください。登記簿が時間内に応答しない場合は、Retry-After付きで504が返ります。その場合は何も課金されません。

fetch-document パラメータ、レスポンス、エラーの詳細。書類をダウンロードする最初の書類までステップごとに。