基本数据 – 文档 | handelsregister.ai

示例

本页的示例来自对 Hetzner Online GmbH（Ansbach HRB 6089）的一次示例请求。如果其登记条目发生变化，你自己的请求会返回不同的值。

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "keywords": [12    "Dedicated Server",13    "Cloud Hosting",14    "Webhosting",15    "Colocation",16    "Object Storage",17    "Domainregistrierung",18    "SSL-Zertifikate",19    "Web-Hosting-Unternehmen"20  ],21  "products_and_services": [22    "Dedizierte Root-Server (Dedicated Servers)",23    "Cloud-Server und virtuelle Server",24    "Managed Server",25    "Webhosting (Shared Hosting)",26    "Colocation Rack / Rechenzentrumsflächen",27    "Storage Box / Object Storage / Storage Share",28    "Domain-Registrierung",29    "SSL-Zertifikate",30    "Load Balancer",31    "DNS Console",32    "Registration Robot",33    "Custom Solutions"34  ],35  "industry_classification": {36    "WZ2008": [37      {38        "code": "62.01.0",39        "label": "Erbringung von Dienstleistungen der Informationstechnologie"40      },41      {42        "code": "63.11.0",43        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44      },45      {46        "code": "61.90.0",47        "label": "Telekommunikation, sonstige"48      }49    ],50    "WZ2025": [51      {52        "code": "62.20.1",53        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54      },55      {56        "code": "46.50.1",57        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58      },59      {60        "code": "62.90.0",61        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62      }63    ]64  },65  "contact_data": {66    "website": "https://www.hetzner.com/",67    "phone_number": "09831 5050",68    "email": "[email protected]"69  },70  "address": {71    "house_number": "25",72    "street": "Industriestraße",73    "postal_code": "91710",74    "city": "Gunzenhausen",75    "county": "Weißenburg-Gunzenhausen",76    "state": "Bayern",77    "country": "DEU",78    "coordinates": {79      "latitude": 49.12483,80      "longitude": 10.7805281    }82  },83  "seat": {84    "city": "Gunzenhausen"85  },86  "registration_date": null,87  "representation_scheme": {88    "current": [89      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."90    ],91    "history": [92      {93        "value": [94          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."95        ],96        "effective_from": "2002-10-15",97        "effective_to": "2015-07-28"98      },99      {100        "value": [101          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102        ],103        "effective_from": "2015-07-28",104        "effective_to": null105      }106    ]107  },108  "capital": {109    "current": {110      "amount": 50000,111      "currency": "EUR",112      "kind": "STAMMKAPITAL"113    },114    "history": [115      {116        "value": {117          "amount": 50000,118          "currency": "EUR",119          "kind": "GRUNDKAPITAL"120        },121        "effective_from": "2002-10-15",122        "effective_to": null123      }124    ]125  },126  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",127  "meta": {128    "request_credit_cost": 5,129    "credits_remaining": 145130  }131}

200 · 示例响应：Hetzner Online GmbH（Ansbach HRB 6089）的基础数据

名称和法律形式

名称、法律形式和状态描述公司，entity_id 用于识别公司。如果你以后想再次获取或监控某家公司，或将其与你自己的数据关联，请保存 entity_id。

字段
字段	含义	示例	可用性
entity_idstring	公司在 handelsregister.ai 的 ID。请将其作为键保存在你的数据中。在参数 q 中，它精确匹配这家公司。基本数据	`"94eb910fef13f94585c48c263fa446d4"`	总是
namestring	登记册中的公司名称，含法律形式后缀。	`"Hetzner Online GmbH"`	同上
legal_formstring	法律形式，通常为常见的德文缩写。请不区分大小写地比较，因为写法可能略有不同，例如 oHG。使用 AI 模式时，可能出现完整形式。列表显示常见取值；还有更多。取值: `GmbH` Gesellschaft mit beschränkter Haftung（有限责任公司）, `UG (haftungsbeschränkt)` Unternehmergesellschaft（迷你 GmbH）, `AG` Aktiengesellschaft（股份公司）, `SE` Societas Europaea（欧洲公司）, `KGaA` Kommanditgesellschaft auf Aktien（股份两合公司）, `GmbH & Co. KG` 以 GmbH 为无限责任合伙人的 KG, `KG` Kommanditgesellschaft（有限合伙）, `OHG` Offene Handelsgesellschaft（普通合伙）, `e.K.` eingetragener Kaufmann（登记的独资商人）, `eG` eingetragene Genossenschaft（登记合作社）, `PartG` Partnerschaftsgesellschaft（自由职业者合伙企业），也包括职业责任有限的形式, `e.V.` eingetragener Verein（登记社团）, `eGbR` eingetragene Gesellschaft bürgerlichen Rechts（登记的民法合伙）	`"GmbH"`	同上
statusstring	公司的登记状态。也可能出现其他取值；请将未知取值视为“非存续”。取值: `ACTIVE` 存续, `INSOLVENT` 处于破产程序中, `DISSOLVED` 已解散，清算中, `TERMINATED` 已从登记册注销	`"ACTIVE"`	同上

登记条目

登记法院、登记类型和登记号共同识别一家公司。我们将它们写在一起，在示例中为“Ansbach HRB 6089”。你也可以按这种形式在参数 q 中传入。

字段
字段	含义	示例	可用性
registrationobject\|null	公司的登记条目。为空：AI 模式仅从网络来源知道这家公司；此时其 entity_id 以 AI_TMP_ 开头基本数据	–	总是
registration.courtstring	登记法院的地名，不含“Amtsgericht”（地方法院），例如 Ansbach 或 Charlottenburg (Berlin)。	`"Ansbach"`	同上
registration.register_typestring	登记类型，即登记册，对于 Handelsregister 还包括其部分。取值: `HRB` Handelsregister B 部分：GmbH、UG、AG、SE、KGaA, `HRA` Handelsregister A 部分：e.K.、OHG、KG、GmbH & Co. KG, `GnR` Genossenschaftsregister（合作社登记册）, `PR` Partnerschaftsregister（合伙登记册）, `VR` Vereinsregister（社团登记册）, `GsR` eGbR 的 Gesellschaftsregister（合伙登记册）	`"HRB"`	同上
registration.register_numberstring	登记号，文本。只有与登记法院和登记类型一起才是唯一的。	`"6089"`	同上
registration_datestring\|null	登记日期，ISO 8601 时间戳。为空：未记录日期	`"2013-03-18T00:00:00+00:00"`	大多: GmbH、UG, AG、SE、KGaA, KG、OHG, eG, PartG 很少: GmbH & Co. KG, e.K.

登记号只有与其登记法院一起才是唯一的。许多法院可能有相同的号码。

地址和注册地

address 是营业地址，seat 是登记册中的注册地（Sitz）。两者可能不同，例如公司在慕尼黑登记，却在 Gauting 经营。

字段
字段	含义	示例	可用性
addressobject	公司的营业地址。基本数据	–	总是
address.streetstring\|null	街道，不含门牌号。为空：地址仅含城市	`"Industriestraße"`	大多
address.house_numberstring\|null	门牌号，文本，也可带后缀，如“6 a”。为空：地址没有门牌号	`"25"`	同上
address.postal_codestring\|null	邮政编码，文本，以保留前导零。为空：地址仅含城市	`"91710"`	同上
address.citystring	营业地址所在城市。	`"Gunzenhausen"`	总是
address.countystring	县（Landkreis）或不属县的城市。部分地址中缺少此键。	`"Weißenburg-Gunzenhausen"`	大多
address.statestring	联邦州（Bundesland）。部分地址中缺少此键。	`"Bayern"`	同上
address.countrystring	国家，三字母 ISO 3166 代码，例如 DEU。部分地址中缺少此键。	`"DEU"`	同上
address.coordinatesobject	营业地址的地理坐标，用于地图和半径搜索。	–	同上
address.coordinates.latitudenumber\|null	纬度，十进制度数。为空：地址无法进行地理编码	`49.12483`	同上
address.coordinates.longitudenumber\|null	经度，十进制度数。为空：地址无法进行地理编码	`10.78052`	同上
seatobject	公司在登记册中的注册地（Sitz）。	–	总是
seat.citystring	注册地所在城市。可能与营业地址不同。	`"Gunzenhausen"`	同上

经营范围和行业

GmbH、UG、AG、SE、KGaA、eG 和 PartG 的经营范围（Unternehmensgegenstand）记载于登记册中。GmbH & Co. KG、KG、OHG 和独资商人（e.K.）不登记经营范围。行业、关键词以及产品与服务适用于所有法律形式。

字段
字段	含义	示例	可用性
purposestring\|null	登记册中的经营范围，德文。使用 AI 模式时，这是业务的简短摘要，也适用于未登记经营范围的法律形式。为空：该法律形式不登记经营范围，例如 KG、OHG 和 e.K.基本数据	`"Die Durchführung von Internet- und Netzwerkdienstleistun…"`	总是: GmbH、UG, AG、SE、KGaA, eG, PartG 从不: GmbH & Co. KG, KG、OHG, e.K.
industry_classificationobject	按德国经济活动分类（WZ）划分的行业，两个版本。	–	总是
industry_classification.WZ2025array	按 WZ 2025（现行版本）划分的行业代码。搜索的行业筛选条件也使用这些代码。为空：无法归入任何行业	–	大多
industry_classification.WZ2025[].codestring	五位 WZ 代码，例如 62.20.1。	`"62.20.1"`	同上
industry_classification.WZ2025[].labelstring	经济活动名称，德文。	`"Erbringung von Beratungsleistungen auf dem Gebiet der In…"`	同上
industry_classification.WZ2008array	按旧版 WZ 2008 划分的行业代码，适用于仍在使用它的系统。为空：没有 WZ 2008 归类	–	部分
industry_classification.WZ2008[].codestring	按 WZ 2008 的五位 WZ 代码。	`"62.01.0"`	同上
industry_classification.WZ2008[].labelstring	经济活动名称，德文。	`"Erbringung von Dienstleistungen der Informationstechnolo…"`	同上
keywordsarray	关于公司业务的关键词，从公开网络来源收集。使用 AI 模式时会扩充。为空：公司在网络上的存在感很低	–	同上
products_and_servicesarray	公司的产品与服务列表，从公开网络来源收集。使用 AI 模式时会扩充。为空：公司在网络上的存在感很低	–	同上

使用 AI 模式时，purpose 包含业务的简短摘要，而不是登记册原文。AI 模式还会补充来自网络的关键词以及产品与服务。

资本

资合公司登记其资本（Stammkapital 或 Grundkapital），每次变更都附日期。current 是现行金额，history 是按时间顺序排列的变更。合伙企业和独资商人没有固定资本；此时 current 为 null，history 为空。

字段
字段	含义	示例	可用性
capitalobject	登记资本及其历史。基本数据	–	总是
capital.currentobject\|null	现行资本金额。为空：该法律形式不登记固定资本，例如 KG、OHG、e.K. 和 PartG	–	总是: GmbH、UG, AG、SE、KGaA 很少: eG 从不: GmbH & Co. KG, KG、OHG, e.K., PartG
capital.current.amountnumber	金额，数字，币种见 currency。	`50000`	同上
capital.current.currencystring	币种，ISO 4217 代码，几乎总是 EUR。	`"EUR"`	同上
capital.current.kindstring	资本类型。也可能出现其他取值。取值: `STAMMKAPITAL` GmbH 或 UG 的 Stammkapital（注册资本）, `GRUNDKAPITAL` AG、SE 或 KGaA 的 Grundkapital（股本）, `LIABILITY_SUM` Haftsumme（责任金额），例如合作社的, `CONDITIONAL` AG 的有条件资本，见于较早的条目	`"STAMMKAPITAL"`	同上
capital.historyarray	所有已登记金额，按时间顺序，包括现行金额。	–	同上
capital.history[].valueobject	金额，含 amount、currency 和 kind，结构与 current 相同。	–	同上
capital.history[].value.change_amountobject	根据登记条目的变更金额，含 amount 和 currency。资本是增加还是减少，需与前一金额比较得出。	–	部分: AG、SE、KGaA 很少: GmbH、UG, eG 从不: GmbH & Co. KG, KG、OHG, e.K., PartG
capital.history[].effective_fromstring\|null	自该日起生效，格式为 YYYY-MM-DD。	`"2002-10-15"`	总是: GmbH、UG, AG、SE、KGaA 很少: eG 从不: GmbH & Co. KG, KG、OHG, e.K., PartG
capital.history[].effective_tostring\|null	有效至该日。为空：该金额仍然有效	`"2005-02-28"`	同上

我们自动从登记条目中读取资本历史。我们为此采用最新技术，并在质量上投入大量精力；个别错误仍可能出现。

代表规则

代表规则（Vertretungsregelung）规定谁可以代表公司行事。响应按登记册原文以德文提供。在我们对 Hetzner Online GmbH 的示例请求中，历史记录在 2015 年 7 月 28 日之前列出的是董事会（Vorstand），之后是总经理。个人的权限见代表权。

字段
字段	含义	示例	可用性
representation_schemeobject	公司的一般代表规则及其历史。基本数据	–	总是: GmbH、UG, GmbH & Co. KG, KG、OHG, eG, PartG 大多: AG、SE、KGaA, e.K.
representation_scheme.currentarray\|null	现行规则，文本段落列表，按登记册原文。为空：未登记规则	–	同上
representation_scheme.historyarray	所有已登记版本及其有效期，包括现行版本。	–	同上
representation_scheme.history[].valuearray	此版本的文本，段落列表。	–	同上
representation_scheme.history[].effective_fromstring\|null	自该日起生效，格式为 YYYY-MM-DD。	`"2002-10-15"`	同上
representation_scheme.history[].effective_tostring\|null	有效至该日。为空：该版本仍然有效	`"2015-07-28"`	同上

使用实时模式时，history 为空。现行版本位于 current 中。

联系方式和网络

联系数据不在登记册中。我们从公司网站收集这些数据。因此是否有数据，取决于公司在网络上公开了什么。

字段
字段	含义	示例	可用性
contact_dataobject	来自公司网站的联系数据。基本数据	–	总是
contact_data.websitestring\|null	网站地址。为空：未找到网站	`"https://www.hetzner.com/"`	部分
contact_data.phone_numberstring\|null	公司公布的电话号码。格式未经规范化。为空：未找到号码	`"09831 5050"`	同上
contact_data.emailstring\|null	公司的通用电子邮件地址。为空：未找到地址	`"[email protected]"`	同上
website_contentstring\|null	网站文本，Markdown 格式，例如用于你自己的分析或语言模型。随功能 website_content 提供，仅与 AI 模式一起使用，不额外收费。为空：未找到网站`website_content`	`"Dedicated Servers, Cloud & Hosting from Germany \| Hetzne…"`	同上

实时模式

使用 realtime_mode=handelsregister-default 时，API 还会实时查询 Handelsregister。响应中随后包含当前登记的人员，以及含查询结果的 _realtime_mode。实时模式仅在查询成功时计费，但届时无论返回什么都会计费。

字段
字段	含义	示例	可用性
_realtime_modeobject	实时查询的结果。仅在你请求了 realtime_mode 时出现在响应中。基本数据	–	总是
_realtime_mode.modestring	所请求的模式，handelsregister-default。	`"handelsregister-default"`	同上
_realtime_mode.statusstring	实时查询是否成功。为其他任何取值时，响应包含已存储的数据，实时模式不计费。取值: `success` 实时查询成功，数据直接来自 Handelsregister	`"success"`	同上

实时查询耗时较长，请将客户端的超时设置为至少 120 秒。如果实时查询失败，API 会返回已存储的数据。此时 _realtime_mode.status 不是 success，实时模式不计费。如果请求耗时过长，你会收到 408，不收费；请稍后再试。

继续阅读

fetch-organization 返回基本数据的端点，含参数和错误。人员与代表总经理、Prokura 和合伙人及其权限。基本概念如何解读 current 和 history、null 和空列表。数据可用性登记册按法律形式包含哪些内容，以及数据来自哪里。