人物と代表
誰が企業を経営し、代表しているか。
登記簿には企業の人物が記載されています：業務執行者、取締役会、支配人、所有者、社員、KGやOHGの社員。企業プロフィールは、機能related_persons（経営陣）でそれらを返します。現在と過去の人物が、それぞれ役割、期間、代表権付きで得られます。
個々の人物については、人物プロフィールがさらに多くを返します：他の企業でのすべての役割、出資、Web調査。
人物を取得する
機能related_personsをリクエストします。そのときレスポンスには、2つのリストを持つキーrelated_personsが含まれます：現在その役割にある全員のcurrentと、退任した全員のpastです。各役割がそれぞれ1つの項目です。Hetzner Online GmbH（Ansbach HRB 6089）の例のリクエストでは、currentに3人の業務執行者がいました。そのうち2人は、以前の支配権（Prokura）とともにpastにも現れました。レスポンス例の個人データはすべてサンプルデータです。
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=related_persons'
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": ["related_persons"], }, ) 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", "related_persons"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();
1{2 "name": "Hetzner Online GmbH",3 "related_persons": {4 "current": [5 {6 "entity_id": "ea3a1670232611a992727ed067216d07",7 "label": "MANAGING_DIRECTOR",8 "role": {9 "en": {10 "long": "Managing Director",11 "short": "MD"12 },13 "de": {14 "long": "Geschäftsführer",15 "short": "GF"16 }17 },18 "name": "Paul Musterwald",19 "start_date": "2019-01-04",20 "end_date": null,21 "birth_date": "1989-07-18",22 "name_parts": {23 "given": "Paul",24 "family": "Musterwald",25 "maiden": null,26 "canonical_name": "Musterwald, Paul",27 "previous_names": null28 },29 "location": {30 "home": {31 "city": "Exempelingen i. Bay."32 }33 },34 "organization_representation_scheme": {35 "current": [36 "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."37 ],38 "history": [39 {40 "value": [41 "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."42 ],43 "effective_from": "2002-10-15",44 "effective_to": "2015-07-28"45 },46 {47 "value": [48 "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."49 ],50 "effective_from": "2015-07-28",51 "effective_to": null52 }53 ]54 },55 "role_representation_scheme": {56 "current": [57 "einzelvertretungsberechtigt."58 ],59 "history": [60 {61 "value": [62 "einzelvertretungsberechtigt."63 ],64 "effective_from": "2019-01-04",65 "effective_to": null66 }67 ]68 }69 },70 {71 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72 "label": "MANAGING_DIRECTOR",73 "role": {74 "en": {75 "long": "Managing Director",76 "short": "MD"77 },78 "de": {79 "long": "Geschäftsführer",80 "short": "GF"81 }82 },83 "name": "Jan Musterhuber",84 "start_date": "2019-01-04",85 "end_date": null,86 "birth_date": "1955-11-06",87 "name_parts": {88 "given": "Jan",89 "family": "Musterhuber",90 "maiden": null,91 "canonical_name": "Musterhuber, Jan",92 "previous_names": null93 },94 "location": {95 "home": {96 "city": "Probeingen"97 }98 },99 "organization_representation_scheme": {100 "current": [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 "history": [104 {105 "value": [106 "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."107 ],108 "effective_from": "2002-10-15",109 "effective_to": "2015-07-28"110 },111 {112 "value": [113 "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."114 ],115 "effective_from": "2015-07-28",116 "effective_to": null117 }118 ]119 },120 "role_representation_scheme": {121 "current": [122 "einzelvertretungsberechtigt."123 ],124 "history": [125 {126 "value": [127 "einzelvertretungsberechtigt."128 ],129 "effective_from": "2019-01-04",130 "effective_to": null131 }132 ]133 }134 },135 {136 "entity_id": "08ed5f967956831ca6588930fd2693ed",137 "label": "MANAGING_DIRECTOR",138 "role": {139 "en": {140 "long": "Managing Director",141 "short": "MD"142 },143 "de": {144 "long": "Geschäftsführer",145 "short": "GF"146 }147 },148 "name": "Max Felix Mustermann",149 "start_date": "2015-07-28",150 "end_date": null,151 "birth_date": "1976-01-15",152 "name_parts": {153 "given": "Max Felix",154 "family": "Mustermann",155 "maiden": null,156 "canonical_name": "Mustermann, Max Felix",157 "previous_names": null158 },159 "location": {160 "home": {161 "city": "Musterheim"162 }163 },164 "organization_representation_scheme": {165 "current": [166 "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."167 ],168 "history": [169 {170 "value": [171 "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."172 ],173 "effective_from": "2002-10-15",174 "effective_to": "2015-07-28"175 },176 {177 "value": [178 "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."179 ],180 "effective_from": "2015-07-28",181 "effective_to": null182 }183 ]184 },185 "role_representation_scheme": {186 "current": [187 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188 ],189 "history": [190 {191 "value": [192 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193 ],194 "effective_from": "2015-07-28",195 "effective_to": null196 }197 ]198 }199 }200 ],201 "past": [202 {203 "entity_id": "ea3a1670232611a992727ed067216d07",204 "label": "PROCURA",205 "role": {206 "en": {207 "long": "Procura",208 "short": "Procura"209 },210 "de": {211 "long": "Prokura",212 "short": "Prokura"213 }214 },215 "name": "Paul Musterwald",216 "start_date": "2015-07-28",217 "end_date": "2019-01-04",218 "birth_date": "1989-07-18",219 "name_parts": {220 "given": "Paul",221 "family": "Musterwald",222 "maiden": null,223 "canonical_name": "Musterwald, Paul",224 "previous_names": null225 },226 "location": {227 "home": {228 "city": "Exempelingen i. Bay."229 }230 },231 "organization_representation_scheme": {232 "latest": [233 "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."234 ],235 "history": [236 {237 "value": [238 "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."239 ],240 "effective_from": "2002-10-15",241 "effective_to": "2015-07-28"242 },243 {244 "value": [245 "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."246 ],247 "effective_from": "2015-07-28",248 "effective_to": null249 }250 ]251 },252 "role_representation_scheme": {253 "latest": [254 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255 ],256 "history": [257 {258 "value": [259 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260 ],261 "effective_from": "2015-07-28",262 "effective_to": "2019-01-04"263 }264 ]265 }266 },267 {268 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269 "label": "PROCURA",270 "role": {271 "en": {272 "long": "Procura",273 "short": "Procura"274 },275 "de": {276 "long": "Prokura",277 "short": "Prokura"278 }279 },280 "name": "Jan Musterhuber",281 "start_date": "2015-07-28",282 "end_date": "2019-01-04",283 "birth_date": "1955-11-06",284 "name_parts": {285 "given": "Jan",286 "family": "Musterhuber",287 "maiden": null,288 "canonical_name": "Musterhuber, Jan",289 "previous_names": null290 },291 "location": {292 "home": {293 "city": "Probeingen"294 }295 },296 "organization_representation_scheme": {297 "latest": [298 "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."299 ],300 "history": [301 {302 "value": [303 "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."304 ],305 "effective_from": "2002-10-15",306 "effective_to": "2015-07-28"307 },308 {309 "value": [310 "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."311 ],312 "effective_from": "2015-07-28",313 "effective_to": null314 }315 ]316 },317 "role_representation_scheme": {318 "latest": [319 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320 ],321 "history": [322 {323 "value": [324 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325 ],326 "effective_from": "2015-07-28",327 "effective_to": "2019-01-04"328 }329 ]330 }331 },332 {333 "entity_id": "08ed5f967956831ca6588930fd2693ed",334 "label": "BOARD",335 "role": {336 "en": {337 "long": "Board Member",338 "short": "Board"339 },340 "de": {341 "long": "Vorstandsmitglied",342 "short": "Vorstand"343 }344 },345 "name": "Max Felix Mustermann",346 "start_date": "2002-10-15",347 "end_date": "2015-07-28",348 "birth_date": "1976-01-15",349 "name_parts": {350 "given": "Max Felix",351 "family": "Mustermann",352 "maiden": null,353 "canonical_name": "Mustermann, Max Felix",354 "previous_names": null355 },356 "location": {357 "home": {358 "city": "Musterheim"359 }360 },361 "organization_representation_scheme": {362 "latest": [363 "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."364 ],365 "history": [366 {367 "value": [368 "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."369 ],370 "effective_from": "2002-10-15",371 "effective_to": "2015-07-28"372 },373 {374 "value": [375 "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."376 ],377 "effective_from": "2015-07-28",378 "effective_to": null379 }380 ]381 },382 "role_representation_scheme": {383 "latest": [384 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385 ],386 "history": [387 {388 "value": [389 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390 ],391 "effective_from": "2002-10-15",392 "effective_to": "2015-07-28"393 }394 ]395 }396 }397 ]398 }399}
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| related_personsobject|null |
企業のすべての登記された人物。currentとpastに分かれます。related_persons |
– | 常に |
| related_persons.currentarray | 現在その役割にある人物。 | – | 上記と同じ |
| related_persons.pastarray | 退任した人物。currentと同じフィールドを持ちます。2つの代表権の定めでは、latestがcurrentの代わりになります：退任前の最後の版です。空になる場合：登記以来誰も退任していない場合 | – | ほとんど |
人物のフィールド
currentとpastのすべての項目は同じフィールドを持ちます。リアルタイムなしでは、人物はすべての企業プロフィールと人物プロフィールで同じentity_idを持ちます。そのため、企業をまたいで同じ人物だとわかります。リアルタイム照会からの人物には独自のIDがあります。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| related_persons.current[].entity_idstring|null |
人物のID。リアルタイムなしでは、すべての企業プロフィールで同じで、人物プロフィールのentity_idと一致します。related_persons |
"ea3a1670232611a992727ed067216d07" |
常に |
| related_persons.current[].labelstring |
固定値としての役割。ほかの値もありえます。値: MANAGING_DIRECTOR 業務執行者（Geschäftsführer）, TEMPORARY_MANAGING_DIRECTOR 緊急業務執行者（Notgeschäftsführer）, BOARD 取締役会（Vorstand）のメンバー, BOARD_CHAIR 取締役会の議長, DIRECTOR 業務執行取締役。例えばSEの, PROCURA 支配人（Prokurist）, LIQUIDATOR 清算人, INSOLVENCY_ADMINISTRATOR 倒産管財人, REPRESENTATIVE 常任代理人, FULLY_LIABLE_PARTNER 無限責任社員（persönlich haftender Gesellschafter）, LIMITED_PARTNER 有限責任社員（Kommanditist）, PARTNER 社員（パートナー）, OWNER 所有者（Inhaber）, PROPRIETOR 所有者（Inhaber）, TREASURER 社団の会計担当, SECRETARY 社団の書記, YOUTH_WARDEN 社団の青少年担当, WATER_WARDEN 社団の水利担当, OTHER その他の役割 |
"MANAGING_DIRECTOR" |
上記と同じ |
| related_persons.current[].roleobject | 表示用の役割名。deとenで、それぞれ長い形（long）と短い形（short）。例えばGeschäftsführerとGF。 | – | 上記と同じ |
| related_persons.current[].namestring | 登記簿にあるとおりのフルネーム。 |
"Paul Musterwald" |
上記と同じ |
| related_persons.current[].name_partsobject | 並べ替えと照合用に、各部分に分けた名前。 | – | 上記と同じ |
| related_persons.current[].name_parts.givenstring|null | 名。複数ある場合はすべて。 |
"Paul" |
上記と同じ |
| related_persons.current[].name_parts.familystring|null | 姓。 |
"Musterwald" |
上記と同じ |
| related_persons.current[].name_parts.canonical_namestring|null | 並べ替えと照合用の名前。通常は「姓, 名」の形。 |
"Musterwald, Paul" |
上記と同じ |
| related_persons.current[].name_parts.maidenstring|null | 出生時の姓。空になる場合：登記されていない場合 |
null |
まれ |
| related_persons.current[].name_parts.previous_namesarray|null | 人物の以前の名前のリスト。空になる場合：登記されていない場合 |
null |
上記と同じ |
| related_persons.current[].titlesarray | Dr.などの学位。学位が登記されていなければキーはありません。 | – | 上記と同じ |
| related_persons.current[].birth_datestring|null | 登記されたとおりの生年月日。YYYY-MM-DD形式。空になる場合：日付が登記されていない場合 |
"1989-07-18" |
ほとんど |
| related_persons.current[].locationobject|null | 人物の場所。 | – | 上記と同じ |
| related_persons.current[].location.home.citystring|null | 登記されたとおりの居住地。登記簿には完全な住所はありません。空になる場合：居住地が登記されていない場合 |
"Exempelingen i. Bay." |
上記と同じ |
| related_persons.current[].start_datestring|null | 役割の開始。YYYY-MM-DD形式。空になる場合：開始がわからない場合。例えばリアルタイムで |
"2019-01-04" |
上記と同じ |
| related_persons.current[].end_datestring|null | 役割の終了。pastの人物で設定されます。空になる場合：その役割がまだ続いている場合 |
null |
常に |
業務執行者と取締役会
GmbHやUGの業務執行者（Geschäftsführer）にはラベルMANAGING_DIRECTORが付きます。AG、SE、eGの取締役会（Vorstand）はBOARDで、その議長はBOARD_CHAIRでわかります。企業が解散すると、LIQUIDATORの清算人が代表を引き継ぎます。
役割は常に
labelで確認してください。roleのテキストは表示用です。
支配権（Prokura）
支配権（Prokura）は、ほぼすべての業務で企業を代表する、登記された代理権です。支配人（Prokuristen）にはラベルPROCURAが付きます。単独で行動できるか、他の人と共同でのみ行動できるかはrole_representation_schemeにあります。例えば「Gesamtprokura gemeinsam mit einem Vorstandsmitglied」（取締役1名との共同支配権）です。
無限責任社員
KG、OHG、KGaAでは、無限責任社員（persönlich haftende Gesellschafter）が企業を代表します。ラベルはFULLY_LIABLE_PARTNERです。KGの有限責任社員（Kommanditisten）はLIMITED_PARTNERで、e.K.の所有者はOWNERで、PartGやeGbRの社員はPARTNERで登記簿に記載されます。
GmbH & Co. KGでは、無限責任社員は通常それ自体がGmbHです。その業務執行者は、そのGmbHの企業プロフィールにあります。
法的形態ごとの役割
企業にどの役割があるかは、法的形態から決まります。表は、法的形態ごとに通常目にするラベルを示します。すべてのラベルとその意味は、上のlabelに記載しています。
| 法的形態 | 典型的なラベル |
|---|---|
| GmbH, UG | MANAGING_DIRECTOR、PROCURA、清算中はLIQUIDATOR |
| AG, SE | BOARD、BOARD_CHAIR、PROCURA |
| KGaA | FULLY_LIABLE_PARTNER、PROCURA |
| GmbH & Co. KG | LIMITED_PARTNER、PROCURA |
| KG, OHG | FULLY_LIABLE_PARTNER、KGではLIMITED_PARTNER、PROCURA |
| e.K. | OWNER |
| eG | BOARD、BOARD_CHAIR、PROCURA |
| PartG, eGbR | PARTNER |
| e.V. | BOARD |
代表権
すべての人物には2組の定めが付きます。role_representation_schemeはその人物自身の権限で、例えば「einzelvertretungsberechtigt」（単独代表権あり）です。organization_representation_schemeは企業の一般的な定めで、基本データのrepresentation_schemeと同じです。どちらもcurrentとhistoryを持ち、過去の人物ではlatestがcurrentの代わりになります。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| related_persons.current[].role_representation_schemeobject |
人物自身の代表権。例えば「einzelvertretungsberechtigt」（単独代表権あり）や§ 181 BGBの免除。currentは有効な版、historyはvalue、effective_from、effective_to付きの変更。related_persons |
– |
ほとんど: GmbH、UG, AG、SE、KGaA, GmbH & Co. KG, KG、OHG, eG, PartG まれ: e.K. |
| related_persons.current[].organization_representation_schemeobject | すべての人物に含まれる、企業の一般的な代表権の定め。role_representation_schemeと同じ構造。 | – |
常に: GmbH、UG, GmbH & Co. KG, KG、OHG, eG, PartG ほとんど: AG、SE、KGaA, e.K. |
リアルタイムでの人物
realtime_mode=handelsregister-defaultを使うと、機能related_personsがなくても、現在登記されている人物が商業登記簿から直接得られます。その場合課金されるのはリアルタイムだけで、機能は課金されません。レスポンスにはcurrentのみが含まれます。
このリストではstart_dateとend_dateは空で、名前が短いことがあり、人物のentity_idはリアルタイムなしの場合と異なることがあります。人物は名前と生年月日で照合してください。
リアルタイムとrelated_personsを一緒にリクエストすると、currentはライブ照会から、pastは企業プロフィールから来ます。その場合は機能も課金されます。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| related_persons.current[].name_parts.aliasesarray |
ライブ照会での名前の表記。「姓, 名」の形。リアルタイムの場合のみ。related_persons |
– | 常に |
人物プロフィール
人物プロフィール（fetch-person）は、個々の人物を表します：つながりのあるすべての企業での役割と、公開のWeb情報源がその人物について伝えていること。人物は、名前と、その人物が役割を持つ（または持っていた）企業で見つけます。
人物プロフィールはPlus以上のすべてのクレジットサブスクリプションに含まれます。Webを調査するため、リクエストには10～30秒かかることがよくあります。クライアントのタイムアウトを120秒以上に設定してください。
curl -G "https://handelsregister.ai/api/v1/fetch-person" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'person_q=Max Mustermann' \ --data-urlencode 'organization_q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-person", headers={"x-api-key": "YOUR_API_KEY"}, params={ "person_q": "Max Mustermann", "organization_q": "Hetzner Online GmbH", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-person"); url.searchParams.append("person_q", "Max Mustermann"); url.searchParams.append("organization_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": "08ed5f967956831ca6588930fd2693ed",3 "name": "Max Felix Mustermann",4 "birth_date": "1976-01-15",5 "name_parts": {6 "given": "Max Felix",7 "family": "Mustermann",8 "maiden": null,9 "canonical_name": "Mustermann, Max Felix",10 "previous_names": null11 },12 "location": {13 "home": {14 "city": "Musterheim"15 }16 },17 "bio": "Max Felix Mustermann ist Geschäftsführer der Hetzner Online GmbH und Unternehmer im Bereich Rechenzentren.",18 "expertise": [19 "Rechenzentren",20 "Hosting"21 ],22 "contact": {23 "emails": [24 {25 "address": "[email protected]",26 "type": "organization",27 "label": "Allgemeine Unternehmenskontakt-E-Mail"28 },29 {30 "address": "[email protected]",31 "type": "organization",32 "label": "E-Mail für Produktfeedback"33 }34 ],35 "phones": [36 {37 "number": "+49374574447100",38 "type": "organization",39 "entity": "Hetzner Online GmbH",40 "label": "Öffentliche Unternehmens-Telefonnummer"41 },42 {43 "number": "+49911234226100",44 "type": "organization",45 "entity": "Hetzner Online GmbH",46 "label": "Öffentliche Unternehmens-Telefonnummer"47 },48 {49 "number": "+4998315050",50 "type": "organization",51 "entity": "Hetzner Online GmbH",52 "label": "Zentrale Unternehmensnummer"53 }54 ]55 },56 "profiles": {57 "linkedin": null,58 "other": []59 },60 "affiliations": [61 {62 "organization": "ENSoXX Holding AG",63 "relation": "Vorstandsmitglied"64 },65 {66 "organization": "Hetzner Online GmbH",67 "relation": "Geschäftsführer"68 },69 {70 "organization": "ENSoXX hilft e.V.",71 "relation": "Vorstandsmitglied"72 },73 {74 "organization": "TRAIDY UG (haftungsbeschränkt)",75 "relation": "Geschäftsführer"76 },77 {78 "organization": "HT clean energy GmbH",79 "relation": "Geschäftsführer"80 },81 {82 "organization": "DreamSoXX GmbH",83 "relation": "Geschäftsführer"84 },85 {86 "organization": "Lighthouse GmbH",87 "relation": "Prokura"88 },89 {90 "organization": "ENSoXX GmbH",91 "relation": "Geschäftsführer"92 },93 {94 "organization": "ENSoXX Invest GmbH",95 "relation": "Geschäftsführer"96 },97 {98 "organization": "Sonnenkraft Merkendorf GmbH & Co. KG",99 "relation": "Kommanditist"100 },101 {102 "organization": "Modellsportclub Gunzenhausen e.V.",103 "relation": "Vorstandsmitglied"104 },105 {106 "organization": "possum Projekt 1 GmbH",107 "relation": "Prokura"108 }109 ],110 "handelsregister_roles": [111 {112 "entity_id": "94eb910fef13f94585c48c263fa446d4",113 "name": "Hetzner Online GmbH",114 "label": "BOARD",115 "role": {116 "en": "Board Member",117 "de": "Vorstandsmitglied"118 },119 "start_date": "2002-10-15",120 "end_date": "2015-07-28"121 },122 {123 "entity_id": "0b3435f83ce8591300625100815d4583",124 "name": "Hetzner Online GmbH",125 "label": "BOARD",126 "role": {127 "en": "Board Member",128 "de": "Vorstandsmitglied"129 },130 "start_date": "2002-10-15",131 "end_date": "2015-07-28"132 },133 {134 "entity_id": "0b3435f83ce8591300625100815d4583",135 "name": "Hetzner Online GmbH",136 "label": "MANAGING_DIRECTOR",137 "role": {138 "en": "Managing Director",139 "de": "Geschäftsführer"140 },141 "start_date": "2015-07-28",142 "end_date": null143 },144 {145 "entity_id": "94eb910fef13f94585c48c263fa446d4",146 "name": "Hetzner Online GmbH",147 "label": "MANAGING_DIRECTOR",148 "role": {149 "en": "Managing Director",150 "de": "Geschäftsführer"151 },152 "start_date": "2015-07-28",153 "end_date": null154 },155 {156 "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",157 "name": "ENSoXX GmbH",158 "label": "MANAGING_DIRECTOR",159 "role": {160 "en": "Managing Director",161 "de": "Geschäftsführer"162 },163 "start_date": "2015-08-14",164 "end_date": null165 },166 {167 "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",168 "name": "ENSoXX Holding AG",169 "label": "BOARD",170 "role": {171 "en": "Board Member",172 "de": "Vorstandsmitglied"173 },174 "start_date": "2016-02-03",175 "end_date": null176 },177 {178 "entity_id": "bc1c1e106ade810eb960c779d4c752a8",179 "name": "ENSoXX hilft e.V.",180 "label": "BOARD",181 "role": {182 "en": "Board Member",183 "de": "Vorstandsmitglied"184 },185 "start_date": "2017-02-24",186 "end_date": null187 },188 {189 "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",190 "name": "TRAIDY UG (haftungsbeschränkt)",191 "label": "MANAGING_DIRECTOR",192 "role": {193 "en": "Managing Director",194 "de": "Geschäftsführer"195 },196 "start_date": "2022-03-14",197 "end_date": null198 },199 {200 "entity_id": "4cd425f9ad57d6119f704ba53131b480",201 "name": "Modellsportclub Gunzenhausen e.V.",202 "label": "BOARD",203 "role": {204 "en": "Board Member",205 "de": "Vorstandsmitglied"206 },207 "start_date": "2023-06-06",208 "end_date": "2026-08-12"209 },210 {211 "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",212 "name": "ENSoXX Invest GmbH",213 "label": "MANAGING_DIRECTOR",214 "role": {215 "en": "Managing Director",216 "de": "Geschäftsführer"217 },218 "start_date": "2023-12-13",219 "end_date": null220 },221 {222 "entity_id": "2ab71b59057969183dd811adf9f32ebd",223 "name": "HT clean energy GmbH",224 "label": "MANAGING_DIRECTOR",225 "role": {226 "en": "Managing Director",227 "de": "Geschäftsführer"228 },229 "start_date": "2024-08-20",230 "end_date": null231 },232 {233 "entity_id": "260286ab8baa3a8977fddd56b9361c6c",234 "name": "DreamSoXX GmbH",235 "label": "MANAGING_DIRECTOR",236 "role": {237 "en": "Managing Director",238 "de": "Geschäftsführer"239 },240 "start_date": "2025-01-13",241 "end_date": null242 },243 {244 "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",245 "name": "Lighthouse GmbH",246 "label": "PROCURA",247 "role": {248 "en": "Procura",249 "de": "Prokura"250 },251 "start_date": "2025-03-25",252 "end_date": null253 },254 {255 "entity_id": "232d2ed634eef59eb21836cc47cb5645",256 "name": "Sonnenkraft Merkendorf GmbH & Co. KG",257 "label": "LIMITED_PARTNER",258 "role": {259 "en": "Limited Partner",260 "de": "Kommanditist"261 },262 "start_date": "2026-02-18",263 "end_date": null264 },265 {266 "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",267 "name": "possum Projekt 1 GmbH",268 "label": "PROCURA",269 "role": {270 "en": "Procura",271 "de": "Prokura"272 },273 "start_date": "2026-09-04",274 "end_date": null275 },276 {277 "entity_id": "997f1b8314b8b56573208ae2334abb1d",278 "name": "possum Projekt 1 GmbH",279 "label": "PROCURA",280 "role": {281 "en": "Procura",282 "de": "Prokura"283 },284 "start_date": "2026-09-04",285 "end_date": null286 }287 ],288 "meta": {289 "request_credit_cost": 15,290 "credits_remaining": 145291 }292}
人物
名前、生年月日、居住地は登記簿から来ています。entity_idは、リアルタイムなしの企業プロフィールのrelated_personsと同じです。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| entity_idstring | 人物のID。同じIDが、リアルタイムなしの企業プロフィールのrelated_personsに現れます。人物プロフィール |
"08ed5f967956831ca6588930fd2693ed" |
常に |
| namestring | 登記簿にあるとおりのフルネーム。 |
"Max Felix Mustermann" |
上記と同じ |
| birth_datestring|null | 登記されたとおりの生年月日。YYYY-MM-DD形式。空になる場合：日付が登記されていない場合 |
"1976-01-15" |
ほとんど |
| name_partsobject | 各部分に分けた名前。related_personsと同じ構造。 | – | 常に |
| name_parts.givenstring|null | 名。複数ある場合はすべて。 |
"Max Felix" |
上記と同じ |
| name_parts.familystring|null | 姓。 |
"Mustermann" |
上記と同じ |
| name_parts.canonical_namestring|null | 並べ替えと照合用の名前。通常は「姓, 名」の形。 |
"Mustermann, Max Felix" |
上記と同じ |
| name_parts.maidenstring|null | 出生時の姓。空になる場合：登記されていない場合 |
null |
まれ |
| name_parts.previous_namesarray|null | 人物の以前の名前のリスト。空になる場合：登記されていない場合 |
null |
上記と同じ |
| locationobject | 人物の場所。 | – | ほとんど |
| location.home.citystring|null | 登記されたとおりの居住地。空になる場合：居住地が登記されていない場合 |
"Musterheim" |
上記と同じ |
役割とつながり
handelsregister_rolesは、人物の登記されたすべての役割を、企業とその期間付きで列挙します。企業のentity_idを使ってその企業プロフィールを取得できます。affiliationsは、登記簿とWebからのつながりを簡潔にまとめたものです。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| handelsregister_rolesarray | 人物の登記された役割。企業と期間付き。現在と過去。人物プロフィール | – | 常に |
| handelsregister_roles[].entity_idstring | 企業のentity_id。企業プロフィールのパラメータq用。 |
"0b3435f83ce8591300625100815d4583" |
上記と同じ |
| handelsregister_roles[].namestring | 企業の名称。 |
"Hetzner Online GmbH" |
上記と同じ |
| handelsregister_roles[].labelstring | 固定値としての役割。related_personsのlabelと同じ値。例えばMANAGING_DIRECTOR、BOARD、PROCURA、LIMITED_PARTNER。 |
"BOARD" |
上記と同じ |
| handelsregister_roles[].roleobject | 表示用の役割名。deとenのテキスト。 | – | 上記と同じ |
| handelsregister_roles[].start_datestring|null | 役割の開始。YYYY-MM-DD形式。空になる場合：開始がわからない場合 |
"2002-10-15" |
ほとんど |
| handelsregister_roles[].end_datestring|null | 役割の終了。空になる場合：その役割がまだ続いている場合 |
"2015-07-28" |
常に |
| affiliationsarray | 人物がつながっている企業。それぞれつながりの種類付き。登記簿とWebの情報源からまとめたもの。 | – | 上記と同じ |
| affiliations[].organizationstring | 企業の名称。 |
"ENSoXX Holding AG" |
上記と同じ |
| affiliations[].relationstring | ドイツ語テキストによるつながりの種類。例えばGeschäftsführer（業務執行者）、Prokura（支配権）、Kommanditist（有限責任社員）。 |
"Vorstandsmitglied" |
上記と同じ |
Web調査
短い経歴、専門分野、連絡手段、情報源は、公開のWeb情報源から収集しています。どれだけあるかは、その人物のWebでの露出度によります。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| biostring|null | 1～2文の人物の短い経歴（ドイツ語）。空になる場合：Web上に人物の情報が少なすぎる場合（そのときはnull）人物プロフィール |
"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…" |
ほとんど |
| expertisearray | 人物の専門分野とテーマのリスト。空になる場合：Web上に人物の情報が少なすぎる場合 | – | 上記と同じ |
| contactobject | 公開されている連絡手段。emailsとphones付き。 | – | 常に |
| contact.emailsarray | メールアドレスのリスト。空になる場合：アドレスが見つからなかった場合 | – | まれ |
| contact.emails[].addressstring | メールアドレス。 |
"[email protected]" |
上記と同じ |
| contact.emails[].typestring | アドレスの種類。organizationは、個人のものではなく企業のアドレスを意味します。 |
"organization" |
上記と同じ |
| contact.emails[].labelstring | アドレスの用途を示す短いテキスト。 |
"Allgemeine Unternehmenskontakt-E-Mail" |
上記と同じ |
| contact.phonesarray | 電話番号のリスト。空になる場合：番号が見つからなかった場合 | – | 上記と同じ |
| contact.phones[].numberstring | 番号。通常は国際形式。 |
"+49374574447100" |
上記と同じ |
| contact.phones[].typestring | 番号の種類。organizationは企業の番号を意味します。 |
"organization" |
上記と同じ |
| contact.phones[].entitystring | 番号が属する企業。 |
"Hetzner Online GmbH" |
上記と同じ |
| contact.phones[].labelstring | 番号の用途。例えば代表電話やファクス。 |
"Öffentliche Unternehmens-Telefonnummer" |
上記と同じ |
| profilesobject | 人物に関するWebページ。linkedinとother付き。 | – | 常に |
| profiles.linkedinstring|null | LinkedInプロフィールのアドレス。空になる場合：見つからなかった場合 |
null |
まれ |
| profiles.otherarray | 報道記事やチームページなど、人物に関するその他のページのアドレスのリスト。空になる場合：見つからなかった場合 | – | ほとんど |
この情報はAIが公開情報からまとめています。そのために最新の技術を使い、品質に大きく投資していますが、個別の誤りが生じる可能性はあります。
出資とネットワーク
2つの機能が人物プロフィールを拡張します：shareholdingsは人物が出資している企業を示します。networkは、人物がつながっている企業と人物を2階層にわたって示します。どちらもデータを返した場合にのみ課金されます。
| フィールド | 意味 | 例 | 提供状況 |
|---|---|---|---|
| shareholdingsobject|null |
人物が現在出資している企業。空になる場合：出資がわかっていない場合shareholdings |
– | 一部 |
| shareholdings.holdings.currentarray | 現在の出資のリスト。 | – | 上記と同じ |
| shareholdings.holdings.current[].organizationobject | entity_id、name、status、legal_form、address、registration付きの企業。基本データと同じ構造。 | – | 上記と同じ |
| shareholdings.holdings.current[].ownership.percentagenumber|null | 資本金に占める持分（パーセント）。例えば33.33。 |
100 |
上記と同じ |
| shareholdings.holdings.current[].ownership.contributionobject|null | amountとcurrency付きの出資の額面金額。 | – | 上記と同じ |
| shareholdings.holdings.current[].as_ofstring|null | 情報の日付。YYYY-MM-DD形式。 |
"2025-01-13" |
上記と同じ |
| shareholdings.summary.total_currentinteger | 現在の出資の数。 |
3 |
上記と同じ |
| networkobject|null |
人物が2階層にわたってつながっている企業と人物。企業プロフィールのnetworkと同じ構造。network · Pro 以上 · ベータ |
– | ほとんど |
| network.depthinteger | ネットワークが人物から数えて何階層を含むか。人物自身は階層0です。 |
2 |
上記と同じ |
| network.nodesarray | ノード：entity_id、名前、階層付きの人物（PERSON）と企業（ORGANIZATION）。人物自身はis_rootがtrueです。 | – | 上記と同じ |
| network.connectionsarray | 2つのノード間のつながり。それぞれkind（ROLE、OWNERSHIP、GROUP）、label、期間、is_current付き。 | – | 上記と同じ |