股东与持股 – 文档 | handelsregister.ai

功能
功能	返回内容	积分	可用于
shareholders	股东：当前股东及其股份，以及以往的股东名单	5	所有账户 · Beta
shareholders_deep	深度股东信息：持有人及股份编号、自何时持股，以及最近一次变更了什么	80	Max
ubos	受益所有人（UBO）：公司背后的人员，根据股东名单计算	10	所有账户 · Beta
shareholdings	持股：该公司自身持股的公司	5	所有账户 · Beta

按法律形式划分的股东

登记册中关于所有者的信息取决于法律形式。下表列出你通常能得到的内容。

法律形式
法律形式	响应中的股东
GmbH、UG	依据 § 40 GmbHG 的股东名单中的所有股东，含名义金额和占 Stammkapital（注册资本）的比例，以及以往的名单。
AG、SE、KGaA	仅在个别情况下提供，因为 AG 的股东不在任何公开登记册中。
GmbH & Co. KG	登记册中的有限合伙人（Kommanditisten）及其责任金额，部分情况下还有作为无限责任合伙人的 GmbH。
KG、OHG	已登记的合伙人：KG 为无限责任合伙人（Komplementäre）和有限合伙人，OHG 为承担个人责任的合伙人。
e.K.	所有人。
eG	无。合作社的成员名单不公开。
PartG	已登记的合伙人。

股东名单往往是版式各异的扫描文件。我们自动提取其内容。我们为此采用最新技术，并在质量上投入大量精力；个别错误仍可能出现。

股东

功能 shareholders 返回当前股东：GmbH 来自最新的股东名单，合伙企业和独资商人来自登记册。费用为 5 积分，但仅在列出当前股东时收取。如果只返回以往的名单，则不收费。

entries 中的每个条目描述一个人或一家公司。人员有 first_name、last_name 和 birth_date，公司有 entity_name、country_code 和 registration_reference。

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

import requests

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

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

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

字段
字段	含义	示例	可用性
shareholdersobject\|null	公司的股东：当前状态在 entries 中，以往状态在 history 中。为空：没有已知的股东，例如 AG 或 eG`shareholders` · Beta	–	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders.entriesarray	当前股东，每个人或每家公司一个条目。	–	同上
shareholders.entries[].shareholderobject	持股者：一个人或一家公司，字段如下。	–	同上
shareholders.entries[].shareholder.entity_idstring\|null	人员或公司的 ID，用于获取其人物档案或公司档案。为空：无法确定地匹配该股东	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	同上
shareholders.entries[].shareholder.first_namestring	人员的名，含所有已登记的名。	–	总是: e.K. 大多: GmbH、UG, GmbH & Co. KG, KG、OHG, PartG 很少: AG、SE、KGaA 从不: eG
shareholders.entries[].shareholder.last_namestring	人员的姓。	–	同上
shareholders.entries[].shareholder.birth_datestring\|null	人员的出生日期，格式为 YYYY-MM-DD。为空：文件未给出出生日期	–	同上
shareholders.entries[].shareholder.entity_namestring	作为股东的公司名称。	`"ENSoXX GmbH"`	大多: GmbH、UG, GmbH & Co. KG 很少: AG、SE、KGaA, KG、OHG 从不: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	公司所在国家的三字母 ISO 代码（ISO 3166-1 alpha-3），例如 DEU。	`"DEU"`	同上
shareholders.entries[].shareholder.registration_referencestring\|null	公司的登记条目，文本，与文件中的写法一致。为空：文件未给出登记条目，境外公司常见	`"AG Ansbach HRB 6105"`	同上
shareholders.entries[].shareholder.addressstring\|null	地址、居住地或注册地，文本，与文件中的写法一致。为空：文件未给出地址	`"Gunzenhausen"`	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders.entries[].contributionobject\|null	持股金额，含 amount 和 currency：GmbH 为股份的名义金额，有限合伙人为已登记的责任金额（Haftsumme）。为空：未登记金额，例如承担个人责任的合伙人或 e.K. 的所有人	–	大多: GmbH、UG, GmbH & Co. KG 部分: KG、OHG 很少: AG、SE、KGaA 从不: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	占资本的比例，小数：1 表示 100 %，0.245 表示 24.5 %。为空：无法推算比例，例如合伙企业	`0.945`	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders.entries[].roleobject	角色：label 为固定代码，另有 de 和 en 的长名和短名，例如 Kommanditist 和 Kom.。	–	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders.entries[].role.labelstring	角色的固定代码。可能会新增取值。取值: `SHAREHOLDER` 股东名单所列的股东, `LIMITED_PARTNER` 有限合伙人（Kommanditist）, `FULLY_LIABLE_PARTNER` 承担个人责任的合伙人（persönlich haftender Gesellschafter）, `PARTNER` PartG 的合伙人, `OWNER` e.K. 的所有人	`"SHAREHOLDER"`	同上
shareholders.total_capitalobject\|null	股东名单中的资本，含 amount 和 currency，是 contribution_ratio 的计算基础。为空：名单未给出资本，以及合伙企业	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG

用股东的 entity_id 可获取其自己的公司档案或人物档案。这样就能逐层追踪所有权链。

股东历史

shareholders.history 不额外收费。它包含当前名单的日期以及以往的股东名单，最新的在前。

对于 KG 或 GmbH & Co. KG，前任合伙人位于 register_ownership 中，含登记册中的入伙和退伙日期。对于 OHG、PartG 和 e.K.，可在 shareholders_deep 中找到。

字段
字段	含义	示例	可用性
shareholders.historyobject	股东的以往状态，不额外收费。为空：没有以往状态；此时该字段不存在，例如 OHG、PartG 或 e.K.`shareholders` · Beta	–	大多: GmbH、UG 部分: GmbH & Co. KG, KG、OHG 很少: AG、SE、KGaA 从不: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	entries 所依据的股东名单的日期。为空：股东信息来自登记册	`"2015-08-21"`	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders.history.pastarray	以往的股东名单，最新的在前。为空：只有一份名单	–	同上
shareholders.history.past[].as_ofstring	这份股东名单的日期。	`"2015-07-28"`	同上
shareholders.history.past[].data.total_capitalobject\|null	这份名单中的资本，含 amount 和 currency。较早的名单部分以 DEM 计。	–	同上
shareholders.history.past[].data.shareholdersarray	这份名单中的股东，字段与 entries 相同。	–	同上
shareholders.history.register_ownershipobject	适用于 KG 和 GmbH & Co. KG：登记册中的前任合伙人，位于 past 中。	–	部分: GmbH & Co. KG, KG、OHG 从不: GmbH、UG, AG、SE、KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	前任合伙人，字段与 entries 中相同。	–	同上
shareholders.history.register_ownership.past[].roleobject	其角色，结构与 entries 中的 role 相同。	–	同上
shareholders.history.register_ownership.past[].effective_fromstring\|null	自何时起登记，格式为 YYYY-MM-DD。	`"2022-01-07"`	同上
shareholders.history.register_ownership.past[].effective_tostring\|null	登记至何时。	`"2026-07-06"`	同上
shareholders.history.register_ownership.past[].effective_to_inferredboolean	如果 effective_to 是推算得出、而非明确登记的，则为 true。	`false`	同上
shareholders.history.register_ownership.past[].contributionnull	此处始终为 null。	–	同上
shareholders.history.register_ownership.past[].contribution_rationull	此处始终为 null。	–	同上

深度股东信息

功能 shareholders_deep 包含在 Max 套餐中。费用为 80 积分，但仅在当前文件至少列出一名持有人时收取。

它读取一家公司的所有股东名单，而不仅是最新的一份。因此它能显示某人自何时持股、以往的状态如何，以及最近一份名单改变了什么。

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

import requests

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

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

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

文件。record 说明当前状态来自哪里，share_capital 给出该文件中的资本。

字段
字段	含义	示例	可用性
shareholders_deepobject\|null	持有人、股份、以往文件和最近一次变更。为空：没有已知的当前文件，也没有已登记的合伙人，AG、SE 和 eG 通常如此`shareholders_deep` · Max 起	–	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.recordobject	当前状态所依据的文件：日期和来源。	–	同上
shareholders_deep.record.datestring\|null	文件所指的日期。通常在文件所反映的变更之后不久。为空：股东信息来自登记册（`COMMERCIAL_REGISTER`）	`"2015-08-18"`	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.record.sourcestring	文件类型。取值: `SHAREHOLDER_LIST` 股东名单（Gesellschafterliste）, `FOUNDING_DOCUMENT` 设立文件，即 Musterprotokoll（标准设立记录）或 Gesellschaftsvertrag（公司章程）, `COMMERCIAL_REGISTER` 登记册中已登记的合伙人或所有人	`"SHAREHOLDER_LIST"`	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.share_capitalobject\|null	文件中的资本：value、currency 和 basis。为空：文件未给出资本，且 COMMERCIAL_REGISTER 时始终如此	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	金额的来源。取值: `REPORTED` 文件中载明, `CALCULATED` 根据股份数量和名义金额计算	`"REPORTED"`	同上

持有人。entries 中的每个条目是文件中的一行，股份最大的在前。如果某人有多行，他会在列表中多次出现。

字段
字段	含义	示例	可用性
shareholders_deep.entriesarray	当前持有人，每个条目对应文件中的一行，股份最大的在前。`shareholders_deep` · Max 起	–	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.entries[].holderobject	持有股份者。type 决定后面有哪些字段。	–	同上
shareholders_deep.entries[].holder.typestring	持有人类型。取值: `ORGANIZATION` 公司或其他组织, `PERSON` 自然人, `JOINT` 共同持有的股份，例如继承人共同体，含 members	`"ORGANIZATION"`	同上
shareholders_deep.entries[].holder.entity_idstring\|null	持有人的 ID，用于获取其公司档案或人物档案。为空：无法确定地匹配该持有人，且 JOINT 时始终如此	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	同上
shareholders_deep.entries[].holder.namestring	名称。已匹配的持有人为当前名称，否则与文件一致。	`"ENSoXX GmbH"`	同上
shareholders_deep.entries[].holder.birth_datestring\|null	仅限人员：出生日期。为空：文件未给出	–	总是: e.K. 大多: GmbH、UG, GmbH & Co. KG, KG、OHG, PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.entries[].holder.legal_formstring\|null	仅限组织：法律形式，文本，例如 GmbH 或 Ltd.。	`"GmbH"`	大多: GmbH、UG, GmbH & Co. KG 很少: AG、SE、KGaA, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	仅限组织：在登记册中的当前状态。为空：持有人未匹配，且在 history 的以往文件中始终如此取值: `ACTIVE` 存续, `INACTIVE` 不再存续，例如已注销或已合并	`"ACTIVE"`	同上
shareholders_deep.entries[].holder.citystring\|null	注册地或居住地。	`"Gunzenhausen"`	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.entries[].holder.countrystring\|null	国家，三字母 ISO 代码（ISO 3166-1 alpha-3），例如 DEU、AUT 或 LUX。	`"DEU"`	同上
shareholders_deep.entries[].holder.registrationobject\|null	仅限组织：court、register_type 和 register_number。为空：无法读取登记条目，例如许多境外公司	–	大多: GmbH、UG, GmbH & Co. KG 很少: AG、SE、KGaA, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	仅限组织：登记条目的文本，当 registration 缺失或未列出法院时提供。	`null`	很少
shareholders_deep.entries[].rolestring	持有人的角色。可能会新增取值。取值: `SHAREHOLDER` 股东名单或设立文件所列的股东, `LIMITED_PARTNER` 有限合伙人（Kommanditist）, `FULLY_LIABLE_PARTNER` 承担个人责任的合伙人（persönlich haftender Gesellschafter）, `PARTNER` PartG 的合伙人, `OWNER` e.K. 的所有人	`"SHAREHOLDER"`	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.entries[].sincestring\|null	持有人自何时持股。对于已登记的合伙人，为登记日期。为空：无法确定日期，且 JOINT 时始终如此	`"2015-08-18"`	同上
shareholders_deep.entries[].since_basisstring\|null	since 的确定程度。取值: `ENTRY_RECORDED` 自此日期起有据可查：之前的名单尚未列出该持有人, `EARLIEST_RECORD` 已出现在现有最早的文件中，因此至少自此日期起为股东	`"ENTRY_RECORDED"`	同上

股份。ownership 描述持有人持有多少：百分比、名义金额以及股份的顺序编号。

字段
字段	含义	示例	可用性
shareholders_deep.entries[].ownershipobject	持有人的股份。`shareholders_deep` · Max 起	–	大多: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG 很少: AG、SE、KGaA 从不: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	占资本的百分比，0 至 100。这是直接持股比例，不是表决权。为空：无法可靠确定比例，且合伙企业已登记的合伙人始终如此	`94.5`	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	percentage 的来源。取值: `REPORTED` 文件中载明，或根据文件中的名义金额和资本推算, `CALCULATED` 根据股份数量和名义金额计算	`"REPORTED"`	同上
shareholders_deep.entries[].ownership.nominal_amountobject\|null	名义金额之和，含 value 和 currency。有限合伙人为已登记的责任金额（Haftsumme）。为空：金额未知	–	大多: GmbH、UG, GmbH & Co. KG 部分: KG、OHG 很少: AG、SE、KGaA 从不: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	股份（Geschäftsanteile）数量。为空：并非所有股份的数量都已知	`47250`	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	按名单中顺序编号列出的股份，每段连续的相同股份为一个区间。	–	同上
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	区间的第一个顺序编号。	`1`	同上
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	区间的最后一个顺序编号。	`47250`	同上
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	区间内的股份数量。	`47250`	同上
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	区间内每份股份的名义金额，含 value 和 currency。	–	同上

历史与变更。history 包含以往的文件，字段相同。持有人按当时文件中的状态出现。changes 将当前状态与上一状态进行比较。

字段
字段	含义	示例	可用性
shareholders_deep.historyarray	以往的文件，最新的在前，各含 record、share_capital 和 entries。已退出的登记合伙人汇总在最后一个条目中。`shareholders_deep` · Max 起	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	适用于 JOINT：类型为 PERSON 或 ORGANIZATION 的共同持有人，字段与 holder 相同。	–	很少
shareholders_deep.history[].entries[].untilstring\|null	仅见于 history 中来源为 COMMERCIAL_REGISTER 的条目：合伙人何时退出。	–	部分: GmbH & Co. KG, KG、OHG, PartG 很少: e.K. 从不: GmbH、UG, AG、SE、KGaA, eG
shareholders_deep.changesobject\|null	当前文件相对上一份文件发生了哪些变化。为空：没有以往文件，或当前状态来自登记册或设立文件	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	上一份文件的日期。	`"2015-07-16"`	同上
shareholders_deep.changes.joinedarray	新持有人：holder（含 entity_id、type 和 name）以及 percentage。	–	同上
shareholders_deep.changes.leftarray	已退出的持有人，含其最后持有的股份。	–	同上
shareholders_deep.changes.changedarray	股份发生变化的持有人。	–	同上
shareholders_deep.changes.changed[].percentage_beforenumber\|null	上一份文件中的持股百分比。	`100`	同上
shareholders_deep.changes.changed[].percentage_afternumber\|null	当前文件中的持股百分比。	`5.5`	同上

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholders_deep": {5    "record": {6      "date": "2015-08-18",7      "source": "SHAREHOLDER_LIST"8    },9    "share_capital": {10      "value": 50000,11      "currency": "EUR",12      "basis": "REPORTED"13    },14    "entries": [15      {16        "holder": {17          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",18          "type": "ORGANIZATION",19          "name": "ENSoXX GmbH",20          "legal_form": "GmbH",21          "status": "ACTIVE",22          "city": "Gunzenhausen",23          "country": "DEU",24          "registration": {25            "court": "Ansbach",26            "register_type": "HRB",27            "register_number": "6105"28          },29          "registration_text": null30        },31        "role": "SHAREHOLDER",32        "ownership": {33          "percentage": 94.5,34          "percentage_basis": "REPORTED",35          "nominal_amount": {36            "value": 47250,37            "currency": "EUR"38          },39          "share_count": 47250,40          "share_ranges": [41            {42              "from": 1,43              "to": 47250,44              "count": 47250,45              "nominal_value": {46                "value": 1,47                "currency": "EUR"48              }49            }50          ]51        },52        "since": "2015-08-18",53        "since_basis": "ENTRY_RECORDED"54      },55      {56        "holder": {57          "entity_id": "08ed5f967956831ca6588930fd2693ed",58          "type": "PERSON",59          "name": "Max Felix Mustermann",60          "birth_date": "1976-01-15",61          "city": "Musterheim",62          "country": "DEU"63        },64        "role": "SHAREHOLDER",65        "ownership": {66          "percentage": 5.5,67          "percentage_basis": "REPORTED",68          "nominal_amount": {69            "value": 2750,70            "currency": "EUR"71          },72          "share_count": 2750,73          "share_ranges": [74            {75              "from": 47251,76              "to": 50000,77              "count": 2750,78              "nominal_value": {79                "value": 1,80                "currency": "EUR"81              }82            }83          ]84        },85        "since": "2015-07-16",86        "since_basis": "EARLIEST_RECORD"87      }88    ],89    "history": [90      {91        "record": {92          "date": "2015-07-16",93          "source": "SHAREHOLDER_LIST"94        },95        "share_capital": {96          "value": 50000,97          "currency": "EUR",98          "basis": "REPORTED"99        },100        "entries": [101          {102            "holder": {103              "entity_id": "08ed5f967956831ca6588930fd2693ed",104              "type": "PERSON",105              "name": "Max Mustermann",106              "birth_date": "1976-01-15",107              "city": null,108              "country": null109            },110            "role": "SHAREHOLDER",111            "ownership": {112              "percentage": 100,113              "percentage_basis": "REPORTED",114              "nominal_amount": {115                "value": 50000,116                "currency": "EUR"117              },118              "share_count": 50000,119              "share_ranges": [120                {121                  "from": 1,122                  "to": 50000,123                  "count": 50000,124                  "nominal_value": {125                    "value": 1,126                    "currency": "EUR"127                  }128                }129              ]130            },131            "since": "2015-07-16",132            "since_basis": "EARLIEST_RECORD"133          }134        ]135      }136    ],137    "changes": {138      "compared_to": "2015-07-16",139      "joined": [140        {141          "holder": {142            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",143            "type": "ORGANIZATION",144            "name": "ENSoXX GmbH"145          },146          "percentage": 94.5147        }148      ],149      "left": [],150      "changed": [151        {152          "holder": {153            "entity_id": "08ed5f967956831ca6588930fd2693ed",154            "type": "PERSON",155            "name": "Max Felix Mustermann"156          },157          "percentage_before": 100,158          "percentage_after": 5.5159        }160      ]161    }162  }163}

200 · 示例响应：带功能 shareholders_deep 的 Hetzner Online GmbH

与 shareholders 相比，shareholders_deep 额外提供股份编号、持股起始日期、变更，以及共同持有的股份及其成员。跨公司和跨年份比较时，最好始终使用同一个功能。

受益所有人

受益所有人是最终拥有一家公司的自然人。功能 ubos 沿股东名单跨越各所有权层级一直追溯到人员。列表列出每个有计算份额的人，没有最低门槛。返回数据时，费用为 10 积分。

如果某份股份无法追溯到人员，它会连同原因出现在 unresolved_beneficial_owners 中。通常是由一家境外公司持有。我们的数据覆盖德国公司，因此不知道境外公司的股东。coverage 显示资本中有多少百分比已追溯到人员，还有多少未解析。两个值相加不一定等于 100。其余部分，股东数据中没有列出持有人。

此功能一旦返回结果即计费。即使所有股份都在 unresolved_beneficial_owners 中也是如此。

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

import requests

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

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

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

字段
字段	含义	示例	可用性
ubosobject\|null	受益所有人，根据股东名单跨所有权层级计算。为空：无法根据股东名单建立链条，例如 AG、eG 或 e.K.`ubos` · Beta	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
ubos.beneficial_ownersarray	直接或通过其他公司拥有该公司的人员。为空：没有任何股份能追溯到人员	–	同上
ubos.beneficial_owners[].personobject	人员，字段如下。	–	部分: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	人员的 ID，用于获取人物档案。为空：无法确定地匹配该人员	–	同上
ubos.beneficial_owners[].person.namestring	全名。	–	同上
ubos.beneficial_owners[].person.name_partsobject	拆分后的姓名：given 和 family，已知时还有 canonical_name。	–	同上
ubos.beneficial_owners[].person.birth_datestring\|null	出生日期。	–	同上
ubos.beneficial_owners[].person.locationobject\|null	home 中的居住地：city、county、state 和 country。为空：居住地未知	–	同上
ubos.beneficial_owners[].ownership_percentagenumber	此人的总持股百分比，所有路径相加。	`50`	同上
ubos.beneficial_owners[].pathsarray	通往此人的每条路径，附该路径上的份额。	–	同上
ubos.beneficial_owners[].paths[].percentagenumber	通过此路径到达的百分比份额。	`50`	同上
ubos.beneficial_owners[].paths[].viaarray	此路径上的公司，首先是所请求公司的直接股东（depth 1）。字段与未解析股份的 via 相同。为空：此人直接持股	–	同上

字段
字段	含义	示例	可用性
ubos.unresolved_beneficial_ownersarray	无法追溯到人员的股份。为空：所有股份都已解析`ubos` · Beta	–	大多: GmbH、UG 很少: AG、SE、KGaA, GmbH & Co. KG, KG、OHG 从不: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	链条在此中断的原因。可能会新增取值。取值: `unlinked` 该股东是一家我们无法与德国登记册中条目匹配的公司，通常是境外公司。我们不知道其股东，因此链条在此中断, `no_further_shareholder_data` 该股东是我们已知的德国公司，但没有它的股东名单，例如 KG, `cycle` 链条回到了已在链中的公司，例如公司持有自身股份, `unknown` 关于该股东一无所知，既无名称也无份额	`"cycle"`	同上
ubos.unresolved_beneficial_owners[].namestring\|null	链条中断处股东的名称。为空：原因为 unknown	`"ENSoXX Holding AG"`	同上
ubos.unresolved_beneficial_owners[].entity_idstring\|null	其 ID，用于获取其公司档案。为空：该股东未与我们数据中的公司匹配，即原因为 unlinked 和 unknown 时	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	同上
ubos.unresolved_beneficial_owners[].legal_formstring\|null	其法律形式。	`"AG"`	同上
ubos.unresolved_beneficial_owners[].addressobject\|array	其地址，含 street、house_number、postal_code、city、county、state、country 和 coordinates。为空：地址未知；此时值为空列表 []	–	同上
ubos.unresolved_beneficial_owners[].registrationobject\|array	其登记条目，含 court、register_type 和 register_number，也包括境外登记册。为空：登记条目未知；此时值为空列表 []	–	同上
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	未解析的百分比份额，一直计算到所请求的公司。可能为 0。	`0`	同上
ubos.unresolved_beneficial_owners[].viaarray	链条到此为止经过的公司，首先是所请求公司的直接股东。为空：未解析的股份直接持有所请求公司	–	同上
ubos.unresolved_beneficial_owners[].via[].depthinteger	层级：1 为所请求公司的直接股东。旁边是该公司的 name 和 entity_id。	`1`	同上
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	在该层级的百分比份额。	`94.5`	同上
ubos.coverageobject	资本中有多少已追溯到人员、有多少尚未解析。两个值相加不一定等于 100。	–	同上
ubos.coverage.resolved_percentagenumber	已追溯到人员的百分比。	`5.5`	同上
ubos.coverage.unresolved_percentagenumber	未追溯到人员的百分比。	`0`	同上

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "ubos": {5    "beneficial_owners": [6      {7        "person": {8          "entity_id": "08ed5f967956831ca6588930fd2693ed",9          "name": "Max Felix Mustermann",10          "birth_date": "1976-01-15",11          "name_parts": {12            "given": "Max Felix",13            "family": "Mustermann",14            "canonical_name": "Mustermann, Max Felix"15          },16          "location": {17            "home": {18              "city": "Musterheim",19              "county": "Musterheim (Landkreis)",20              "state": "Bayern",21              "country": "DEU"22            }23          }24        },25        "ownership_percentage": 5.5,26        "paths": [27          {28            "percentage": 5.5,29            "via": []30          }31        ]32      }33    ],34    "unresolved_beneficial_owners": [35      {36        "reason": "cycle",37        "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",38        "name": "ENSoXX Holding AG",39        "legal_form": "AG",40        "address": {41          "house_number": "25",42          "street": "Industriestraße",43          "postal_code": "91710",44          "city": "Gunzenhausen",45          "county": "Weißenburg-Gunzenhausen",46          "state": "Bayern",47          "country": "DEU",48          "coordinates": {49            "latitude": 49.12483,50            "longitude": 10.7805251          }52        },53        "registration": {54          "court": "Ansbach",55          "register_type": "HRB",56          "register_number": "6211"57        },58        "ownership_percentage": 0,59        "via": [60          {61            "depth": 1,62            "name": "ENSoXX GmbH",63            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",64            "step_percentage": 94.565          },66          {67            "depth": 2,68            "name": "ENSoXX Holding AG",69            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",70            "step_percentage": 10071          }72        ]73      },74      {75        "reason": "unknown",76        "entity_id": null,77        "name": null,78        "legal_form": null,79        "address": [],80        "registration": [],81        "ownership_percentage": 0,82        "via": [83          {84            "depth": 1,85            "name": "ENSoXX GmbH",86            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",87            "step_percentage": 94.588          },89          {90            "depth": 2,91            "name": "ENSoXX Holding AG",92            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",93            "step_percentage": 10094          }95        ]96      },97      {98        "reason": "unknown",99        "entity_id": null,100        "name": null,101        "legal_form": null,102        "address": [],103        "registration": [],104        "ownership_percentage": 0,105        "via": [106          {107            "depth": 1,108            "name": "ENSoXX GmbH",109            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",110            "step_percentage": 94.5111          },112          {113            "depth": 2,114            "name": "ENSoXX Holding AG",115            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",116            "step_percentage": 100117          }118        ]119      }120    ],121    "coverage": {122      "resolved_percentage": 5.5,123      "unresolved_percentage": 0124    }125  }126}

200 · 示例响应：带功能 ubos 的 Hetzner Online GmbH。在我们的示例请求中，一名自然人以 5.5% 位于 beneficial_owners 中。经由 ENSoXX GmbH（Ansbach HRB 6105）的链条因原因 cycle 和 unknown 止于 unresolved_beneficial_owners。

我们根据股东名单计算这些数据。自 2022 年底起，Transparenzregister（透明度登记册）中的受益所有人数据已不再公开。

持股

功能 shareholdings 显示另一个方向：所请求的公司持有哪些公司的股份。这些持股来自那些公司的股东名单。有持股时，费用为 5 积分。

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

import requests

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

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

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

字段
字段	含义	示例	可用性
shareholdingsobject\|null	所请求公司持股的公司。为空：没有已知的持股`shareholdings` · Beta	–	大多: AG、SE、KGaA 部分: GmbH、UG 很少: GmbH & Co. KG, KG、OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	当前持股，每家公司一条。	–	同上
shareholdings.holdings.current[].organizationobject	被持股的公司。	–	同上
shareholdings.holdings.current[].organization.entity_idstring	公司的 ID，用于获取其公司档案。	`"63529c3a793e9f002196b4fd344e1241"`	同上
shareholdings.holdings.current[].organization.namestring\|null	公司名称。	`"Hetzner Cloud GmbH"`	同上
shareholdings.holdings.current[].organization.legal_formstring\|null	公司的法律形式。	`"GmbH"`	同上
shareholdings.holdings.current[].organization.statusstring\|null	公司在登记册中的状态，例如 ACTIVE。	`"ACTIVE"`	同上
shareholdings.holdings.current[].organization.addressobject\|array	公司地址，结构与基础数据中的 address 相同。为空：地址未知；此时值为空列表 []	–	同上
shareholdings.holdings.current[].organization.registrationobject\|array	公司的登记条目，含 court、register_type 和 register_number。为空：登记条目未知；此时值为空列表 []	–	同上
shareholdings.holdings.current[].ownership.percentagenumber\|null	持股百分比：100 表示 100 %。为空：名单无法得出份额	`100`	同上
shareholdings.holdings.current[].ownership.contributionobject	股份的名义金额，含 amount 和 currency。	–	同上
shareholdings.holdings.current[].as_ofstring	持股信息所依据的股东名单的日期。	`"2017-09-19"`	同上
shareholdings.summary.total_currentinteger	当前持股数量。	`2`	同上

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholdings": {5    "holdings": {6      "current": [7        {8          "organization": {9            "entity_id": "63529c3a793e9f002196b4fd344e1241",10            "name": "Hetzner Cloud GmbH",11            "status": "ACTIVE",12            "legal_form": "GmbH",13            "address": {14              "house_number": "12A",15              "street": "Feringastraße",16              "postal_code": "85774",17              "city": "Unterföhring",18              "county": "München (Landkreis)",19              "state": "Bayern",20              "country": "DEU",21              "coordinates": {22                "latitude": 48.17815,23                "longitude": 11.6348724              }25            },26            "registration": {27              "court": "München",28              "register_type": "HRB",29              "register_number": "226782"30            }31          },32          "ownership": {33            "percentage": 100,34            "contribution": {35              "amount": 25000,36              "currency": "EUR"37            }38          },39          "as_of": "2017-09-19"40        },41        {42          "organization": {43            "entity_id": "997f1b8314b8b56573208ae2334abb1d",44            "name": "possum Projekt 1 GmbH",45            "status": "ACTIVE",46            "legal_form": "GmbH",47            "address": {48              "house_number": "169-173",49              "street": "Meisenburgstraße",50              "postal_code": "45133",51              "city": "Essen",52              "county": "Essen",53              "state": "Nordrhein-Westfalen",54              "country": "DEU",55              "coordinates": {56                "latitude": 51.40102,57                "longitude": 6.9580558              }59            },60            "registration": {61              "court": "Essen",62              "register_type": "HRB",63              "register_number": "35604"64            }65          },66          "ownership": {67            "percentage": 100,68            "contribution": {69              "amount": 25000,70              "currency": "EUR"71            }72          },73          "as_of": "2026-08-18"74        }75      ]76    },77    "summary": {78      "total_current": 279    }80  }81}

200 · 示例响应：带功能 shareholdings 的 Hetzner Online GmbH

一个人的持股见人物档案，使用同一功能。

集团结构

你可以根据多个数据点拼出集团关系。shareholders 和 shareholdings 显示向上和向下一层的持股，ubos 显示链条末端的人员。

公司关系网络跨两个层级连接公司和人员。它也包括关联企业。

合并、分立和其他组织变更见合并与收购。