株主と出資 – ドキュメント

機能
機能	返すもの	クレジット	利用可能
shareholders	株主：現在の株主とその持分、および以前の株主名簿	5	すべてのアカウント · ベータ
shareholders_deep	詳細な株主情報：持分番号付きの保有者、いつから保有しているか、直近で何が変わったか	80	Max
ubos	実質的支配者（UBO）：株主名簿から算出した、企業の背後にいる人物	10	すべてのアカウント · ベータ
shareholdings	出資：企業自身が出資している企業	5	すべてのアカウント · ベータ

法的形態ごとの株主

登記簿が所有者について何を示すかは、法的形態によります。表は、通常得られるものを示します。

法的形態
法的形態	レスポンス内の株主
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` · ベータ	–	ほとんど: GmbH、UG, GmbH & Co. KG, KG、OHG, e.K., PartG まれ: AG、SE、KGaA なし: eG
shareholders.entriesarray	現在の株主。人物または企業ごとに1項目。	–	上記と同じ
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	3文字の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で、その企業プロフィールまたは人物プロフィールを取得できます。そうして所有の連鎖を1階層ずつたどれます。

株主の履歴

shareholders.historyは追加料金なしで付きます。現在の名簿の日付と、以前の株主名簿が新しい順に含まれます。

KGやGmbH & Co. KGでは、過去の社員がregister_ownershipに、登記簿による加入日と退出日付きで入ります。OHG、PartG、e.K.ではshareholders_deepにあります。

フィールド
フィールド	意味	例	提供状況
shareholders.historyobject	追加料金なしの、株主の以前の状態。空になる場合：以前の状態がない場合。そのときフィールドはありません。例えばOHG、PartG、e.K.`shareholders` · ベータ	–	ほとんど: 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	以前の株主名簿。新しい順。空になる場合：名簿が1つしかない場合	–	上記と同じ
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 クレジットかかりますが、現在の書類に1人以上の保有者が記載されている場合のみです。

最新のものだけでなく、企業のすべての株主名簿を読み取ります。そのため、誰がいつから持分を保有しているか、以前の状態がどうだったか、最新の名簿で何が変わったかがわかります。

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の各項目は書類の1行で、持分の大きい順です。複数の行を持つ人は、リストに複数回現れます。

フィールド
フィールド	意味	例	提供状況
shareholders_deep.entriesarray	現在の保有者。書類の1行ごとに1項目、持分の大きい順。`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	3文字の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	名簿の通し番号による持分。同じ持分が続く範囲ごとに1つ。	–	上記と同じ
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付きの、範囲内の持分1つあたりの額面金額。	–	上記と同じ

履歴と変更。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	COMMERCIAL_REGISTERのhistoryの項目のみ：社員が退出した時期。	–	一部: 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	新しい保有者：entity_id、type、name付きのholderと、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は、資本金の何パーセントが人物までたどれ、どれだけが未解決かを示します。2つの値の合計が常に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` · ベータ	–	ほとんど: 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` · ベータ	–	ほとんど: 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はリクエストした企業の直接の株主。その隣に企業の名称とentity_idがあります。	`1`	上記と同じ
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	この階層での持分（パーセント）。	`94.5`	上記と同じ
ubos.coverageobject	資本金のうちどれだけが人物までたどれ、どれだけが未解決か。2つの値の合計が常に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。例のリクエストでは、1人の個人が5.5%でbeneficial_ownersに入っていました。ENSoXX GmbH（Ansbach HRB 6105）を経由する連鎖は、理由cycleとunknownでunresolved_beneficial_ownersに入っていました。

データは株主名簿から算出しています。透明性登記簿（Transparenzregister）の実質的支配者のデータは、2022年末から公開されていません。

出資

機能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` · ベータ	–	ほとんど: AG、SE、KGaA 一部: GmbH、UG まれ: GmbH & Co. KG, KG、OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	現在の出資。企業ごとに1つ。	–	上記と同じ
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は1階層上と下の出資を、ubosは連鎖の終わりにいる人物を示します。

企業ネットワークは、企業と人物を2階層にわたって結び付けます。関連会社も含みます。

合併、分割、その他の組織再編は合併と買収（M&A）にあります。