基本データ

例

このページの例は、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モードがWebの情報源からしか企業を知らない場合。そのときentity_idはAI_TMP_で始まる基本データ	–	常に
registration.courtstring	地名としての登記裁判所。「Amtsgericht」（区裁判所）は付きません。例：AnsbachやCharlottenburg (Berlin)。	`"Ansbach"`	上記と同じ
registration.register_typestring	登記簿の種類。つまり登記簿と、商業登記簿の場合はその部。値: `HRB` 商業登記簿B部：GmbH、UG、AG、SE、KGaA, `HRA` 商業登記簿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）です。例えばミュンヘンで登記され、ガウティングで業務を行っている企業のように、両者が異なることがあります。

フィールド
フィールド	意味	例	提供状況
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	3文字のISO 3166コードによる国（例：DEU）。一部の住所ではキーごとありません。	`"DEU"`	上記と同じ
address.coordinatesobject	地図や半径検索用の、営業所在地の地理座標。	–	上記と同じ
address.coordinates.latitudenumber\|null	10進数の度による緯度。空になる場合：住所をジオコーディングできなかった場合	`49.12483`	上記と同じ
address.coordinates.longitudenumber\|null	10進数の度による経度。空になる場合：住所をジオコーディングできなかった場合	`10.78052`	上記と同じ
seatobject	登記簿上の企業の本店所在地（Sitz）。	–	常に
seat.citystring	本店所在地の市町村。営業所在地と異なることがあります。	`"Gunzenhausen"`	上記と同じ

事業目的と業種

事業目的（Unternehmensgegenstand）は、GmbH、UG、AG、SE、KGaA、eG、PartGでは登記簿にあります。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）による業種。2つの版。	–	常に
industry_classification.WZ2025array	現行版WZ 2025による業種コード。検索の業種フィルターもこのコードを使います。空になる場合：業種を割り当てられなかった場合	–	ほとんど
industry_classification.WZ2025[].codestring	5桁の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による5桁のWZコード。	`"62.01.0"`	上記と同じ
industry_classification.WZ2008[].labelstring	経済活動の名称（ドイツ語）。	`"Erbringung von Dienstleistungen der Informationstechnolo…"`	上記と同じ
keywordsarray	公開のWeb情報源から収集した、企業の事業に関するキーワード。AIモードで拡張されます。空になる場合：企業のWebでの存在感が小さい場合	–	上記と同じ
products_and_servicesarray	公開のWeb情報源から収集した、企業の製品とサービスのリスト。AIモードで拡張されます。空になる場合：企業のWebでの存在感が小さい場合	–	上記と同じ

AIモードでは、purposeに登記簿のテキストの代わりに事業の短い要約が入ります。AIモードは、Webからキーワード、製品とサービスを加えます。

資本金

物的会社は資本金（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にあります。

連絡先とWeb

連絡先は登記簿にはありません。企業のWebサイトから収集しています。そのため、あるかどうかは企業がWebで何を公開しているかによります。

フィールド
フィールド	意味	例	提供状況
contact_dataobject	企業のWebサイトからの連絡先。基本データ	–	常に
contact_data.websitestring\|null	Webサイトのアドレス。空になる場合：Webサイトが見つからなかった場合	`"https://www.hetzner.com/"`	一部
contact_data.phone_numberstring\|null	企業が公開しているとおりの電話番号。形式は正規化されていません。空になる場合：番号が見つからなかった場合	`"09831 5050"`	上記と同じ
contact_data.emailstring\|null	企業の一般的なメールアドレス。空になる場合：アドレスが見つからなかった場合	`"[email protected]"`	上記と同じ
website_contentstring\|null	MarkdownによるWebサイトのテキスト。例えば独自の分析や言語モデル向け。機能website_contentで、AIモードと一緒の場合のみ、追加料金なしで得られます。空になる場合：Webサイトが見つからなかった場合`website_content`	`"Dedicated Servers, Cloud & Hosting from Germany \| Hetzne…"`	上記と同じ

リアルタイム

realtime_mode=handelsregister-defaultを使うと、APIは商業登記簿にもライブで照会します。そのときレスポンスには、現在登記されている人物と、照会の結果を示す_realtime_modeが含まれます。リアルタイムが課金されるのは照会が成功した場合だけですが、その場合は内容にかかわらず課金されます。

フィールド
フィールド	意味	例	提供状況
_realtime_modeobject	リアルタイム照会の結果。realtime_modeをリクエストした場合のみレスポンスに含まれます。基本データ	–	常に
_realtime_mode.modestring	リクエストしたモード、handelsregister-default。	`"handelsregister-default"`	上記と同じ
_realtime_mode.statusstring	ライブ照会が成功したかどうか。それ以外の値では、レスポンスに保存済みのデータが含まれ、リアルタイムは課金されません。値: `success` ライブ照会が成功し、データは商業登記簿から直接来ている	`"success"`	上記と同じ

リアルタイムの照会は時間がかかるため、クライアントのタイムアウトを120秒以上に設定してください。ライブ照会が失敗した場合、APIは保存済みのデータを返します。そのとき_realtime_mode.statusはsuccessではなく、リアルタイムは課金されません。リクエストに時間がかかりすぎると、無料で408が返ります。後でもう一度試してください。

fetch-organization 基本データを返すエンドポイント。パラメータとエラー付き。人物と代表業務執行者、支配権（Prokura）、社員とその権限。基本概念 currentとhistory、nullと空のリストの読み方。データの提供状況法的形態ごとに登記簿に含まれるものと、データの出所。

例