文件

有哪些文件，以什么格式提供。

使用 fetch-document，你可以以文件形式下载登记册中的官方文件。在 company_id 中传入公司的 entity_id，并选择一个 document_type。每份已交付的文件费用为 15 积分。

文件类型

共有五种文件类型。请严格按表中写法填写 document_type 的取值，包括大小写。示例请求获取的是 Hetzner Online GmbH（Ansbach HRB 6089）的 Aktueller Abdruck。

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();

按法律形式划分的文件

每家登记在册的公司都有 Aktueller Abdruck、Chronologischer Abdruck 和 Strukturierter Registerinhalt。除此之外还有哪些已提交的文件，取决于法律形式。

法律形式
法律形式	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 示例中，文件大小如下：Aktueller Abdruck 约 35 KB，Strukturierter Registerinhalt 约 14 KB，Gesellschaftsvertrag 约 450 KB。

我们在需要时直接从登记册获取文件。这可能需要长达两分钟。因此请将客户端的超时设置为至少 120 秒，或使用 async=true 在后台获取文件。如果登记册未及时响应，你会收到带 Retry-After 的 504。此时不收费。

fetch-document 参数、响应和错误详解。下载文件逐步获取你的第一份文件。