handelsregister.ai
تسجيل الدخول إنشاء حساب
التوثيق الشبكة

الشبكة

كيف ترتبط الشركات والأشخاص ببعضهم.

تُظهر الميزة network (شبكة الشركة) كيف ترتبط الشركة بشركات وأشخاص آخرين: عبر مناصب مثل المدير أو Prokura (التوكيل التجاري المسجل)، وعبر المشاركات، وعبر الشركات المرتبطة.

تأتي الروابط من السجل التجاري (Handelsregister) ومن Gesellschafterlisten (قوائم الشركاء). وتمتد إلى مستويين: من الشركة إلى جهات اتصالها المباشرة، ومن هناك مستوى إضافيًا واحدًا.

الميزة متاحة في الخطط Pro و Max ولا تزال في مرحلة Beta. تكلّف 25 رصيد، ولكن فقط عندما تحتوي الشبكة على رابط واحد على الأقل. ومع الخطط الأخرى تتركها الـ API دون خطأ.

البنية

الاستجابة عبارة عن رسم بياني (graph). تحتوي nodes على الشركات والأشخاص، وconnections على الروابط بينهم. ويرتبط الاثنان عبر node_id. 

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=network'
الحقل
الحقل المعنى مثال التوفر
networkobject|null الشبكة حول الشركة: العقد في nodes، والروابط في connections.فارغ عندما لا توجد روابط معروفة للشركةnetwork · بدءًا من Pro · Beta – غالبًا
network.depthinteger عدد المستويات التي تصل إليها الشبكة، محسوبةً من الشركة. الشركة نفسها هي المستوى 0. 2 كما في الأعلى
network.truncatedboolean true إذا لم تكن الشبكة كاملة في الاستجابة. false كما في الأعلى 
1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "network": {5    "depth": 2,6    "nodes": [7      {8        "entity_id": "94eb910fef13f94585c48c263fa446d4",9        "type": "ORGANIZATION",10        "name": "Hetzner Online GmbH",11        "depth": 0,12        "is_root": true,13        "status": "ACTIVE",14        "registration_status": "ACTIVE",15        "cessation_date": null,16        "node_id": "94eb910fef13f94585c48c263fa446d4"17      },18      {19        "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",20        "type": "ORGANIZATION",21        "name": "ENSoXX GmbH",22        "depth": 1,23        "is_root": false,24        "status": "ACTIVE",25        "registration_status": "ACTIVE",26        "cessation_date": null,27        "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"28      },29      {30        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",31        "type": "PERSON",32        "name": "Jan Musterhuber",33        "depth": 1,34        "is_root": false,35        "status": null,36        "registration_status": null,37        "cessation_date": null,38        "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"39      },40      {41        "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",42        "type": "ORGANIZATION",43        "name": "Headtrip GmbH",44        "depth": 1,45        "is_root": false,46        "status": "INACTIVE",47        "registration_status": "TERMINATED",48        "cessation_date": "2023-08-17",49        "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"50      },51      {52        "entity_id": "0b3435f83ce8591300625100815d4583",53        "type": "ORGANIZATION",54        "name": "Hetzner Online AG",55        "depth": 1,56        "is_root": false,57        "status": "ACTIVE",58        "registration_status": "ACTIVE",59        "cessation_date": null,60        "node_id": "0b3435f83ce8591300625100815d4583"61      },62      {63        "entity_id": "08ed5f967956831ca6588930fd2693ed",64        "type": "PERSON",65        "name": "Max Felix Mustermann",66        "depth": 1,67        "is_root": false,68        "status": null,69        "registration_status": null,70        "cessation_date": null,71        "node_id": "08ed5f967956831ca6588930fd2693ed"72      },73      {74        "entity_id": "ea3a1670232611a992727ed067216d07",75        "type": "PERSON",76        "name": "Paul Musterwald",77        "depth": 1,78        "is_root": false,79        "status": null,80        "registration_status": null,81        "cessation_date": null,82        "node_id": "ea3a1670232611a992727ed067216d07"83      },84      {85        "entity_id": "e5bddadd46117c0d0b54f5c8f3334c50",86        "type": "PERSON",87        "name": "Moritz Musterhoff",88        "depth": 2,89        "is_root": false,90        "status": null,91        "registration_status": null,92        "cessation_date": null,93        "node_id": "e5bddadd46117c0d0b54f5c8f3334c50"94      },95      {96        "entity_id": "260286ab8baa3a8977fddd56b9361c6c",97        "type": "ORGANIZATION",98        "name": "DreamSoXX GmbH",99        "depth": 2,100        "is_root": false,101        "status": "ACTIVE",102        "registration_status": "ACTIVE",103        "cessation_date": null,104        "node_id": "260286ab8baa3a8977fddd56b9361c6c"105      },106      {107        "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",108        "type": "ORGANIZATION",109        "name": "ENSoXX Holding AG",110        "depth": 2,111        "is_root": false,112        "status": "ACTIVE",113        "registration_status": "ACTIVE",114        "cessation_date": null,115        "node_id": "58d67a0bb99b2bc5644cb8daba58e6a6"116      },117      {118        "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",119        "type": "ORGANIZATION",120        "name": "ENSoXX Invest GmbH",121        "depth": 2,122        "is_root": false,123        "status": "ACTIVE",124        "registration_status": "ACTIVE",125        "cessation_date": null,126        "node_id": "0e8b1b4fc27a3ecc07d397750505e7b5"127      },128      {129        "entity_id": "bc1c1e106ade810eb960c779d4c752a8",130        "type": "ORGANIZATION",131        "name": "ENSoXX hilft e.V.",132        "depth": 2,133        "is_root": false,134        "status": "ACTIVE",135        "registration_status": "ACTIVE",136        "cessation_date": null,137        "node_id": "bc1c1e106ade810eb960c779d4c752a8"138      },139      {140        "entity_id": "1184637be046741e9f0bb5d401feeb2b",141        "type": "PERSON",142        "name": "Tobias Musterhain",143        "depth": 2,144        "is_root": false,145        "status": null,146        "registration_status": null,147        "cessation_date": null,148        "node_id": "1184637be046741e9f0bb5d401feeb2b"149      },150      {151        "entity_id": "2ab71b59057969183dd811adf9f32ebd",152        "type": "ORGANIZATION",153        "name": "HT clean energy GmbH",154        "depth": 2,155        "is_root": false,156        "status": "ACTIVE",157        "registration_status": "ACTIVE",158        "cessation_date": null,159        "node_id": "2ab71b59057969183dd811adf9f32ebd"160      },161      {162        "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",163        "type": "ORGANIZATION",164        "name": "Lighthouse GmbH",165        "depth": 2,166        "is_root": false,167        "status": "ACTIVE",168        "registration_status": "ACTIVE",169        "cessation_date": null,170        "node_id": "7582db1f94e1538ba8f531f6a95a7f1b"171      },172      {173        "entity_id": "4cd425f9ad57d6119f704ba53131b480",174        "type": "ORGANIZATION",175        "name": "Modellsportclub Gunzenhausen e.V.",176        "depth": 2,177        "is_root": false,178        "status": "ACTIVE",179        "registration_status": "ACTIVE",180        "cessation_date": null,181        "node_id": "4cd425f9ad57d6119f704ba53131b480"182      },183      {184        "entity_id": "232d2ed634eef59eb21836cc47cb5645",185        "type": "ORGANIZATION",186        "name": "Sonnenkraft Merkendorf GmbH & Co. KG",187        "depth": 2,188        "is_root": false,189        "status": "ACTIVE",190        "registration_status": "ACTIVE",191        "cessation_date": null,192        "node_id": "232d2ed634eef59eb21836cc47cb5645"193      },194      {195        "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",196        "type": "ORGANIZATION",197        "name": "TRAIDY UG (haftungsbeschränkt)",198        "depth": 2,199        "is_root": false,200        "status": "ACTIVE",201        "registration_status": "ACTIVE",202        "cessation_date": null,203        "node_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10"204      },205      {206        "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",207        "type": "ORGANIZATION",208        "name": "possum Projekt 1 GmbH",209        "depth": 2,210        "is_root": false,211        "status": "ACTIVE",212        "registration_status": "ACTIVE",213        "cessation_date": null,214        "node_id": "64922d416b4dd7006f3c2c62efaabd5d"215      },216      {217        "entity_id": "997f1b8314b8b56573208ae2334abb1d",218        "type": "ORGANIZATION",219        "name": "possum Projekt 1 GmbH",220        "depth": 2,221        "is_root": false,222        "status": "ACTIVE",223        "registration_status": "ACTIVE",224        "cessation_date": null,225        "node_id": "997f1b8314b8b56573208ae2334abb1d"226      }227    ],228    "connections": [229      {230        "source": {231          "entity_id": "08ed5f967956831ca6588930fd2693ed",232          "type": "PERSON",233          "name": "Max Felix Mustermann",234          "node_id": "08ed5f967956831ca6588930fd2693ed"235        },236        "target": {237          "entity_id": "94eb910fef13f94585c48c263fa446d4",238          "type": "ORGANIZATION",239          "name": "Hetzner Online GmbH",240          "node_id": "94eb910fef13f94585c48c263fa446d4"241        },242        "connection_type": "ROLE",243        "label": "BOARD",244        "role": {245          "en": {246            "long": "Board Member",247            "short": "Board"248          },249          "de": {250            "long": "Vorstandsmitglied",251            "short": "Vorstand"252          }253        },254        "start_date": "2002-10-15",255        "end_date": "2015-07-28",256        "is_current": false,257        "depth": 1,258        "effective_end_date": "2015-07-28",259        "end_reason": "ROLE_ENDED"260      },261      {262        "source": {263          "entity_id": "08ed5f967956831ca6588930fd2693ed",264          "type": "PERSON",265          "name": "Max Felix Mustermann",266          "node_id": "08ed5f967956831ca6588930fd2693ed"267        },268        "target": {269          "entity_id": "94eb910fef13f94585c48c263fa446d4",270          "type": "ORGANIZATION",271          "name": "Hetzner Online GmbH",272          "node_id": "94eb910fef13f94585c48c263fa446d4"273        },274        "connection_type": "ROLE",275        "label": "MANAGING_DIRECTOR",276        "role": {277          "en": {278            "long": "Managing Director",279            "short": "MD"280          },281          "de": {282            "long": "Geschäftsführer",283            "short": "GF"284          }285        },286        "start_date": "2015-07-28",287        "end_date": null,288        "is_current": true,289        "depth": 1,290        "effective_end_date": null,291        "end_reason": null292      },293      {294        "source": {295          "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",296          "type": "PERSON",297          "name": "Jan Musterhuber",298          "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"299        },300        "target": {301          "entity_id": "94eb910fef13f94585c48c263fa446d4",302          "type": "ORGANIZATION",303          "name": "Hetzner Online GmbH",304          "node_id": "94eb910fef13f94585c48c263fa446d4"305        },306        "connection_type": "ROLE",307        "label": "PROCURA",308        "role": {309          "en": {310            "long": "Procura",311            "short": "Procura"312          },313          "de": {314            "long": "Prokura",315            "short": "Prokura"316          }317        },318        "start_date": "2015-07-28",319        "end_date": "2019-01-04",320        "is_current": false,321        "depth": 1,322        "effective_end_date": "2019-01-04",323        "end_reason": "ROLE_ENDED"324      },325      {326        "source": {327          "entity_id": "ea3a1670232611a992727ed067216d07",328          "type": "PERSON",329          "name": "Paul Musterwald",330          "node_id": "ea3a1670232611a992727ed067216d07"331        },332        "target": {333          "entity_id": "94eb910fef13f94585c48c263fa446d4",334          "type": "ORGANIZATION",335          "name": "Hetzner Online GmbH",336          "node_id": "94eb910fef13f94585c48c263fa446d4"337        },338        "connection_type": "ROLE",339        "label": "PROCURA",340        "role": {341          "en": {342            "long": "Procura",343            "short": "Procura"344          },345          "de": {346            "long": "Prokura",347            "short": "Prokura"348          }349        },350        "start_date": "2015-07-28",351        "end_date": "2019-01-04",352        "is_current": false,353        "depth": 1,354        "effective_end_date": "2019-01-04",355        "end_reason": "ROLE_ENDED"356      },357      {358        "source": {359          "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",360          "type": "PERSON",361          "name": "Jan Musterhuber",362          "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"363        },364        "target": {365          "entity_id": "94eb910fef13f94585c48c263fa446d4",366          "type": "ORGANIZATION",367          "name": "Hetzner Online GmbH",368          "node_id": "94eb910fef13f94585c48c263fa446d4"369        },370        "connection_type": "ROLE",371        "label": "MANAGING_DIRECTOR",372        "role": {373          "en": {374            "long": "Managing Director",375            "short": "MD"376          },377          "de": {378            "long": "Geschäftsführer",379            "short": "GF"380          }381        },382        "start_date": "2019-01-04",383        "end_date": null,384        "is_current": true,385        "depth": 1,386        "effective_end_date": null,387        "end_reason": null388      },389      {390        "source": {391          "entity_id": "ea3a1670232611a992727ed067216d07",392          "type": "PERSON",393          "name": "Paul Musterwald",394          "node_id": "ea3a1670232611a992727ed067216d07"395        },396        "target": {397          "entity_id": "94eb910fef13f94585c48c263fa446d4",398          "type": "ORGANIZATION",399          "name": "Hetzner Online GmbH",400          "node_id": "94eb910fef13f94585c48c263fa446d4"401        },402        "connection_type": "ROLE",403        "label": "MANAGING_DIRECTOR",404        "role": {405          "en": {406            "long": "Managing Director",407            "short": "MD"408          },409          "de": {410            "long": "Geschäftsführer",411            "short": "GF"412          }413        },414        "start_date": "2019-01-04",415        "end_date": null,416        "is_current": true,417        "depth": 1,418        "effective_end_date": null,419        "end_reason": null420      },421      {422        "source": {423          "entity_id": "08ed5f967956831ca6588930fd2693ed",424          "type": "PERSON",425          "name": "Max Felix Mustermann",426          "node_id": "08ed5f967956831ca6588930fd2693ed"427        },428        "target": {429          "entity_id": "94eb910fef13f94585c48c263fa446d4",430          "type": "ORGANIZATION",431          "name": "Hetzner Online GmbH",432          "node_id": "94eb910fef13f94585c48c263fa446d4"433        },434        "connection_type": "OWNERSHIP",435        "label": "SHAREHOLDER",436        "role": {437          "en": {438            "long": "Shareholder",439            "short": "Shareholder"440          },441          "de": {442            "long": "Gesellschafter",443            "short": "Gesellschafter"444          }445        },446        "start_date": null,447        "end_date": null,448        "is_current": true,449        "depth": 1,450        "ownership": {451          "percentage": 5.5,452          "amount": {453            "value": 2750,454            "currency": "EUR"455          },456          "as_of": "2015-08-21",457          "source": "shareholder_list"458        },459        "effective_end_date": null,460        "end_reason": null461      },462      {463        "source": {464          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",465          "type": "ORGANIZATION",466          "name": "ENSoXX GmbH",467          "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"468        },469        "target": {470          "entity_id": "94eb910fef13f94585c48c263fa446d4",471          "type": "ORGANIZATION",472          "name": "Hetzner Online GmbH",473          "node_id": "94eb910fef13f94585c48c263fa446d4"474        },475        "connection_type": "OWNERSHIP",476        "label": "SHAREHOLDER",477        "role": {478          "en": {479            "long": "Shareholder",480            "short": "Shareholder"481          },482          "de": {483            "long": "Gesellschafter",484            "short": "Gesellschafter"485          }486        },487        "start_date": null,488        "end_date": null,489        "is_current": true,490        "depth": 1,491        "ownership": {492          "percentage": 94.5,493          "amount": {494            "value": 47250,495            "currency": "EUR"496          },497          "as_of": "2015-08-21",498          "source": "shareholder_list"499        },500        "effective_end_date": null,501        "end_reason": null502      },503      {504        "source": {505          "entity_id": "08ed5f967956831ca6588930fd2693ed",506          "type": "PERSON",507          "name": "Max Felix Mustermann",508          "node_id": "08ed5f967956831ca6588930fd2693ed"509        },510        "target": {511          "entity_id": "0b3435f83ce8591300625100815d4583",512          "type": "ORGANIZATION",513          "name": "Hetzner Online AG",514          "node_id": "0b3435f83ce8591300625100815d4583"515        },516        "connection_type": "ROLE",517        "label": "BOARD",518        "role": {519          "en": {520            "long": "Board Member",521            "short": "Board"522          },523          "de": {524            "long": "Vorstandsmitglied",525            "short": "Vorstand"526          }527        },528        "start_date": "2002-10-15",529        "end_date": "2015-07-28",530        "is_current": false,531        "depth": 2,532        "effective_end_date": "2015-07-28",533        "end_reason": "ROLE_ENDED"534      },535      {536        "source": {537          "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",538          "type": "PERSON",539          "name": "Jan Musterhuber",540          "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"541        },542        "target": {543          "entity_id": "0b3435f83ce8591300625100815d4583",544          "type": "ORGANIZATION",545          "name": "Hetzner Online AG",546          "node_id": "0b3435f83ce8591300625100815d4583"547        },548        "connection_type": "ROLE",549        "label": "PROCURA",550        "role": {551          "en": {552            "long": "Procura",553            "short": "Procura"554          },555          "de": {556            "long": "Prokura",557            "short": "Prokura"558          }559        },560        "start_date": "2009-01-02",561        "end_date": null,562        "is_current": true,563        "depth": 2,564        "effective_end_date": null,565        "end_reason": null566      },567      {568        "source": {569          "entity_id": "ea3a1670232611a992727ed067216d07",570          "type": "PERSON",571          "name": "Paul Musterwald",572          "node_id": "ea3a1670232611a992727ed067216d07"573        },574        "target": {575          "entity_id": "0b3435f83ce8591300625100815d4583",576          "type": "ORGANIZATION",577          "name": "Hetzner Online AG",578          "node_id": "0b3435f83ce8591300625100815d4583"579        },580        "connection_type": "ROLE",581        "label": "PROCURA",582        "role": {583          "en": {584            "long": "Procura",585            "short": "Procura"586          },587          "de": {588            "long": "Prokura",589            "short": "Prokura"590          }591        },592        "start_date": "2009-01-02",593        "end_date": null,594        "is_current": true,595        "depth": 2,596        "effective_end_date": null,597        "end_reason": null598      },599      {600        "source": {601          "entity_id": "08ed5f967956831ca6588930fd2693ed",602          "type": "PERSON",603          "name": "Max Felix Mustermann",604          "node_id": "08ed5f967956831ca6588930fd2693ed"605        },606        "target": {607          "entity_id": "0b3435f83ce8591300625100815d4583",608          "type": "ORGANIZATION",609          "name": "Hetzner Online AG",610          "node_id": "0b3435f83ce8591300625100815d4583"611        },612        "connection_type": "ROLE",613        "label": "MANAGING_DIRECTOR",614        "role": {615          "en": {616            "long": "Managing Director",617            "short": "MD"618          },619          "de": {620            "long": "Geschäftsführer",621            "short": "GF"622          }623        },624        "start_date": "2015-07-28",625        "end_date": null,626        "is_current": true,627        "depth": 2,628        "effective_end_date": null,629        "end_reason": null630      },631      {632        "source": {633          "entity_id": "08ed5f967956831ca6588930fd2693ed",634          "type": "PERSON",635          "name": "Max Felix Mustermann",636          "node_id": "08ed5f967956831ca6588930fd2693ed"637        },638        "target": {639          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",640          "type": "ORGANIZATION",641          "name": "ENSoXX GmbH",642          "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"643        },644        "connection_type": "ROLE",645        "label": "MANAGING_DIRECTOR",646        "role": {647          "en": {648            "long": "Managing Director",649            "short": "MD"650          },651          "de": {652            "long": "Geschäftsführer",653            "short": "GF"654          }655        },656        "start_date": "2015-08-14",657        "end_date": null,658        "is_current": true,659        "depth": 2,660        "effective_end_date": null,661        "end_reason": null662      },663      {664        "source": {665          "entity_id": "08ed5f967956831ca6588930fd2693ed",666          "type": "PERSON",667          "name": "Max Felix Mustermann",668          "node_id": "08ed5f967956831ca6588930fd2693ed"669        },670        "target": {671          "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",672          "type": "ORGANIZATION",673          "name": "ENSoXX Holding AG",674          "node_id": "58d67a0bb99b2bc5644cb8daba58e6a6"675        },676        "connection_type": "ROLE",677        "label": "BOARD",678        "role": {679          "en": {680            "long": "Board Member",681            "short": "Board"682          },683          "de": {684            "long": "Vorstandsmitglied",685            "short": "Vorstand"686          }687        },688        "start_date": "2016-02-03",689        "end_date": null,690        "is_current": true,691        "depth": 2,692        "effective_end_date": null,693        "end_reason": null694      },695      {696        "source": {697          "entity_id": "1184637be046741e9f0bb5d401feeb2b",698          "type": "PERSON",699          "name": "Tobias Musterhain",700          "node_id": "1184637be046741e9f0bb5d401feeb2b"701        },702        "target": {703          "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",704          "type": "ORGANIZATION",705          "name": "Headtrip GmbH",706          "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"707        },708        "connection_type": "ROLE",709        "label": "MANAGING_DIRECTOR",710        "role": {711          "en": {712            "long": "Managing Director",713            "short": "MD"714          },715          "de": {716            "long": "Geschäftsführer",717            "short": "GF"718          }719        },720        "start_date": "2016-10-28",721        "end_date": null,722        "is_current": false,723        "depth": 2,724        "effective_end_date": "2023-08-17",725        "end_reason": "ORGANIZATION_TERMINATED"726      },727      {728        "source": {729          "entity_id": "e5bddadd46117c0d0b54f5c8f3334c50",730          "type": "PERSON",731          "name": "Moritz Musterhoff",732          "node_id": "e5bddadd46117c0d0b54f5c8f3334c50"733        },734        "target": {735          "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",736          "type": "ORGANIZATION",737          "name": "Headtrip GmbH",738          "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"739        },740        "connection_type": "ROLE",741        "label": "MANAGING_DIRECTOR",742        "role": {743          "en": {744            "long": "Managing Director",745            "short": "MD"746          },747          "de": {748            "long": "Geschäftsführer",749            "short": "GF"750          }751        },752        "start_date": "2016-10-28",753        "end_date": null,754        "is_current": false,755        "depth": 2,756        "effective_end_date": "2023-08-17",757        "end_reason": "ORGANIZATION_TERMINATED"758      },759      {760        "source": {761          "entity_id": "08ed5f967956831ca6588930fd2693ed",762          "type": "PERSON",763          "name": "Max Felix Mustermann",764          "node_id": "08ed5f967956831ca6588930fd2693ed"765        },766        "target": {767          "entity_id": "bc1c1e106ade810eb960c779d4c752a8",768          "type": "ORGANIZATION",769          "name": "ENSoXX hilft e.V.",770          "node_id": "bc1c1e106ade810eb960c779d4c752a8"771        },772        "connection_type": "ROLE",773        "label": "BOARD",774        "role": {775          "en": {776            "long": "Board Member",777            "short": "Board"778          },779          "de": {780            "long": "Vorstandsmitglied",781            "short": "Vorstand"782          }783        },784        "start_date": "2017-02-24",785        "end_date": null,786        "is_current": true,787        "depth": 2,788        "effective_end_date": null,789        "end_reason": null790      },791      {792        "source": {793          "entity_id": "08ed5f967956831ca6588930fd2693ed",794          "type": "PERSON",795          "name": "Max Felix Mustermann",796          "node_id": "08ed5f967956831ca6588930fd2693ed"797        },798        "target": {799          "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",800          "type": "ORGANIZATION",801          "name": "TRAIDY UG (haftungsbeschränkt)",802          "node_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10"803        },804        "connection_type": "ROLE",805        "label": "MANAGING_DIRECTOR",806        "role": {807          "en": {808            "long": "Managing Director",809            "short": "MD"810          },811          "de": {812            "long": "Geschäftsführer",813            "short": "GF"814          }815        },816        "start_date": "2022-03-14",817        "end_date": null,818        "is_current": true,819        "depth": 2,820        "effective_end_date": null,821        "end_reason": null822      },823      {824        "source": {825          "entity_id": "08ed5f967956831ca6588930fd2693ed",826          "type": "PERSON",827          "name": "Max Felix Mustermann",828          "node_id": "08ed5f967956831ca6588930fd2693ed"829        },830        "target": {831          "entity_id": "4cd425f9ad57d6119f704ba53131b480",832          "type": "ORGANIZATION",833          "name": "Modellsportclub Gunzenhausen e.V.",834          "node_id": "4cd425f9ad57d6119f704ba53131b480"835        },836        "connection_type": "ROLE",837        "label": "BOARD",838        "role": {839          "en": {840            "long": "Board Member",841            "short": "Board"842          },843          "de": {844            "long": "Vorstandsmitglied",845            "short": "Vorstand"846          }847        },848        "start_date": "2023-06-06",849        "end_date": "2026-08-12",850        "is_current": false,851        "depth": 2,852        "effective_end_date": "2026-08-12",853        "end_reason": "ROLE_ENDED"854      },855      {856        "source": {857          "entity_id": "08ed5f967956831ca6588930fd2693ed",858          "type": "PERSON",859          "name": "Max Felix Mustermann",860          "node_id": "08ed5f967956831ca6588930fd2693ed"861        },862        "target": {863          "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",864          "type": "ORGANIZATION",865          "name": "ENSoXX Invest GmbH",866          "node_id": "0e8b1b4fc27a3ecc07d397750505e7b5"867        },868        "connection_type": "ROLE",869        "label": "MANAGING_DIRECTOR",870        "role": {871          "en": {872            "long": "Managing Director",873            "short": "MD"874          },875          "de": {876            "long": "Geschäftsführer",877            "short": "GF"878          }879        },880        "start_date": "2023-12-13",881        "end_date": null,882        "is_current": true,883        "depth": 2,884        "effective_end_date": null,885        "end_reason": null886      },887      {888        "source": {889          "entity_id": "08ed5f967956831ca6588930fd2693ed",890          "type": "PERSON",891          "name": "Max Felix Mustermann",892          "node_id": "08ed5f967956831ca6588930fd2693ed"893        },894        "target": {895          "entity_id": "2ab71b59057969183dd811adf9f32ebd",896          "type": "ORGANIZATION",897          "name": "HT clean energy GmbH",898          "node_id": "2ab71b59057969183dd811adf9f32ebd"899        },900        "connection_type": "ROLE",901        "label": "MANAGING_DIRECTOR",902        "role": {903          "en": {904            "long": "Managing Director",905            "short": "MD"906          },907          "de": {908            "long": "Geschäftsführer",909            "short": "GF"910          }911        },912        "start_date": "2024-08-20",913        "end_date": null,914        "is_current": true,915        "depth": 2,916        "effective_end_date": null,917        "end_reason": null918      },919      {920        "source": {921          "entity_id": "08ed5f967956831ca6588930fd2693ed",922          "type": "PERSON",923          "name": "Max Felix Mustermann",924          "node_id": "08ed5f967956831ca6588930fd2693ed"925        },926        "target": {927          "entity_id": "260286ab8baa3a8977fddd56b9361c6c",928          "type": "ORGANIZATION",929          "name": "DreamSoXX GmbH",930          "node_id": "260286ab8baa3a8977fddd56b9361c6c"931        },932        "connection_type": "ROLE",933        "label": "MANAGING_DIRECTOR",934        "role": {935          "en": {936            "long": "Managing Director",937            "short": "MD"938          },939          "de": {940            "long": "Geschäftsführer",941            "short": "GF"942          }943        },944        "start_date": "2025-01-13",945        "end_date": null,946        "is_current": true,947        "depth": 2,948        "effective_end_date": null,949        "end_reason": null950      },951      {952        "source": {953          "entity_id": "08ed5f967956831ca6588930fd2693ed",954          "type": "PERSON",955          "name": "Max Felix Mustermann",956          "node_id": "08ed5f967956831ca6588930fd2693ed"957        },958        "target": {959          "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",960          "type": "ORGANIZATION",961          "name": "Lighthouse GmbH",962          "node_id": "7582db1f94e1538ba8f531f6a95a7f1b"963        },964        "connection_type": "ROLE",965        "label": "PROCURA",966        "role": {967          "en": {968            "long": "Procura",969            "short": "Procura"970          },971          "de": {972            "long": "Prokura",973            "short": "Prokura"974          }975        },976        "start_date": "2025-03-25",977        "end_date": null,978        "is_current": true,979        "depth": 2,980        "effective_end_date": null,981        "end_reason": null982      },983      {984        "source": {985          "entity_id": "08ed5f967956831ca6588930fd2693ed",986          "type": "PERSON",987          "name": "Max Felix Mustermann",988          "node_id": "08ed5f967956831ca6588930fd2693ed"989        },990        "target": {991          "entity_id": "232d2ed634eef59eb21836cc47cb5645",992          "type": "ORGANIZATION",993          "name": "Sonnenkraft Merkendorf GmbH & Co. KG",994          "node_id": "232d2ed634eef59eb21836cc47cb5645"995        },996        "connection_type": "OWNERSHIP",997        "label": "LIMITED_PARTNER",998        "role": {999          "en": {1000            "long": "Limited Partner",1001            "short": "LP"1002          },1003          "de": {1004            "long": "Kommanditist",1005            "short": "Kom"1006          }1007        },1008        "start_date": "2026-02-18",1009        "end_date": null,1010        "is_current": true,1011        "depth": 2,1012        "ownership": null,1013        "effective_end_date": null,1014        "end_reason": null1015      },1016      {1017        "source": {1018          "entity_id": "08ed5f967956831ca6588930fd2693ed",1019          "type": "PERSON",1020          "name": "Max Felix Mustermann",1021          "node_id": "08ed5f967956831ca6588930fd2693ed"1022        },1023        "target": {1024          "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",1025          "type": "ORGANIZATION",1026          "name": "possum Projekt 1 GmbH",1027          "node_id": "64922d416b4dd7006f3c2c62efaabd5d"1028        },1029        "connection_type": "ROLE",1030        "label": "PROCURA",1031        "role": {1032          "en": {1033            "long": "Procura",1034            "short": "Procura"1035          },1036          "de": {1037            "long": "Prokura",1038            "short": "Prokura"1039          }1040        },1041        "start_date": "2026-09-04",1042        "end_date": null,1043        "is_current": true,1044        "depth": 2,1045        "effective_end_date": null,1046        "end_reason": null1047      },1048      {1049        "source": {1050          "entity_id": "08ed5f967956831ca6588930fd2693ed",1051          "type": "PERSON",1052          "name": "Max Felix Mustermann",1053          "node_id": "08ed5f967956831ca6588930fd2693ed"1054        },1055        "target": {1056          "entity_id": "997f1b8314b8b56573208ae2334abb1d",1057          "type": "ORGANIZATION",1058          "name": "possum Projekt 1 GmbH",1059          "node_id": "997f1b8314b8b56573208ae2334abb1d"1060        },1061        "connection_type": "ROLE",1062        "label": "PROCURA",1063        "role": {1064          "en": {1065            "long": "Procura",1066            "short": "Procura"1067          },1068          "de": {1069            "long": "Prokura",1070            "short": "Prokura"1071          }1072        },1073        "start_date": "2026-09-04",1074        "end_date": null,1075        "is_current": true,1076        "depth": 2,1077        "effective_end_date": null,1078        "end_reason": null1079      }1080    ],1081    "truncated": false1082  }1083}
200 · مثال على استجابة: Hetzner Online GmbH، Ansbach HRB 6089، مع الميزة network، مختصرة

الشركات والأشخاص المرتبطون

كل عقدة هي شركة أو شخص. الشركة المطلوبة موجودة فيها بـ is_root: true وdepth: 0، وجهات اتصالها المباشرة بـ depth: 1، وجهات اتصال هذه بـ depth: 2.

الحقل
الحقل المعنى مثال التوفر
network.nodesarray جميع الشركات والأشخاص في الشبكة، بما في ذلك الشركة المطلوبة.network · بدءًا من Pro · Beta – غالبًا
network.nodes[].node_idstring معرّف العقدة الذي يشير إليه source وtarget. للشركات والأشخاص المطابَقين، هو نفسه الـ entity_id. "94eb910fef13f94585c48c263fa446d4" كما في الأعلى
network.nodes[].entity_idstring|null معرّف الشركة أو الشخص، لملف الشركة أو ملف الشخص الخاص به.فارغ عندما الشريك معروف فقط من قائمة شركاء ولم تتسنَّ مطابقته بيقين "94eb910fef13f94585c48c263fa446d4" كما في الأعلى
network.nodes[].typestring نوع العقدة.القيم: ORGANIZATION شركة, PERSON شخص "ORGANIZATION" كما في الأعلى
network.nodes[].namestring اسم الشركة أو الشخص. "Hetzner Online GmbH" كما في الأعلى
network.nodes[].depthinteger المسافة إلى الشركة المطلوبة: 0 هي الشركة نفسها، و1 جهة اتصال مباشرة، و2 جهة اتصال لجهة اتصال. 0 كما في الأعلى
network.nodes[].is_rootboolean true للشركة المطلوبة فقط. true كما في الأعلى
network.nodes[].statusstring|null للمنظمات فقط: الحالة الحالية في السجل.فارغ عندما العقدة شخصالقيم: ACTIVE نشطة, INACTIVE لم تعد نشطة، مثلًا مشطوبة أو مندمجة "ACTIVE" كما في الأعلى
network.nodes[].registration_statusstring|null حالة الشركة في السجل. قيم أخرى ممكنة؛ تعامل مع القيم غير المعروفة على أنها «غير نشطة».فارغ عندما العقدة شخصالقيم: ACTIVE نشطة, TERMINATED مشطوبة من السجل "ACTIVE" كما في الأعلى
network.nodes[].cessation_datestring|null للشركات التي لم تعد نشطة فقط: التاريخ الذي انتهت فيه الشركة، بالصيغة YYYY-MM-DD.فارغ عندما الشركة نشطة أو العقدة شخص null نادرًا
network.nodes[].registration_referencestring|null للعقد دون entity_id فقط: قيد السجل لشركة، كما يظهر في قائمة الشركاء. – كما في الأعلى
network.nodes[].country_codestring|null للعقد دون entity_id فقط: بلد الشركة كرمز ISO من ثلاثة أحرف. – كما في الأعلى
network.nodes[].birth_datestring|null للعقد دون entity_id فقط: تاريخ ميلاد الشخص من قائمة الشركاء. – كما في الأعلى

بالـ entity_id الخاص بعقدة ما تجلب ملف الشركة أو ملف الشخص الخاص بها، ويمكنك تتبع الشبكة من هناك.

قراءة الروابط

يمتد الرابط من source إلى target. المصدر هو الشخص أو الشركة التي تشغل منصبًا أو تملك حصة أو رابطًا ضمن مجموعة؛ والهدف هو الشركة التي يوجد فيها ذلك.

يخبرك connection_type بنوع الرابط، ويسمّيه label بدقة. وتسميات العرض موجودة في role.de وrole.en.

connection_type
connection_type المعنى القيم المعتادة في label
ROLE منصب في الشركة MANAGING_DIRECTOR, BOARD, PROCURA
OWNERSHIP مشاركة في الشركة SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER
GROUP شركة مرتبطة AFFILIATED_COMPANY
الحقل
الحقل المعنى مثال التوفر
network.connectionsarray جميع الروابط بين العقد، الحالية والمنتهية.network · بدءًا من Pro · Beta – غالبًا
network.connections[].sourceobject من أين يبدأ الرابط: entity_id وnode_id وtype وname. – كما في الأعلى
network.connections[].targetobject الشركة التي يوجد فيها المنصب أو الحصة أو الرابط، بالحقول نفسها. – كما في الأعلى
network.connections[].connection_typestring نوع الرابط.القيم: ROLE منصب, OWNERSHIP مشاركة, GROUP شركة مرتبطة "ROLE" كما في الأعلى
network.connections[].labelstring الاسم الدقيق للرابط. قد تُضاف قيم جديدة.القيم: MANAGING_DIRECTOR مدير (Geschäftsführer), BOARD عضو مجلس الإدارة (Vorstand), BOARD_CHAIR رئيس مجلس الإدارة, DIRECTOR مدير تنفيذي، مثلًا لـ SE, PROCURA حامل Prokura (Prokurist), LIQUIDATOR مصفٍّ, INSOLVENCY_ADMINISTRATOR مدير الإعسار, REPRESENTATIVE ممثل دائم, TREASURER أمين صندوق جمعية, SECRETARY أمين سرّ جمعية, OTHER دور آخر, SHAREHOLDER شريك وفق قائمة الشركاء, LIMITED_PARTNER شريك موصٍ (Kommanditist), FULLY_LIABLE_PARTNER شريك متضامن بمسؤولية شخصية, PARTNER شريك, OWNER مالك, AFFILIATED_COMPANY شركة مرتبطة "BOARD" كما في الأعلى
network.connections[].roleobject تسمية العرض: de وen، لكلٍّ منهما long وshort. – كما في الأعلى
network.connections[].start_datestring|null البداية وفق السجل، بالصيغة YYYY-MM-DD.فارغ عندما لا يذكر السجل تاريخًا "2002-10-15" كما في الأعلى
network.connections[].end_datestring|null النهاية وفق السجل.فارغ عندما الرابط لا يزال قائمًا أو لا يوجد تاريخ معروف "2015-07-28" كما في الأعلى
network.connections[].effective_end_datestring|null متى انتهى الرابط فعليًا: end_date، أو نهاية الشركة إذا لم يذكر السجل نهاية للرابط.فارغ عندما الرابط لا يزال قائمًا أو لا يوجد تاريخ معروف "2015-07-28" كما في الأعلى
network.connections[].end_reasonstring|null لماذا لم يعد الرابط قائمًا. قد تُضاف قيم جديدة.فارغ عندما الرابط لا يزال قائمًاالقيم: ROLE_ENDED أُنهي الرابط, ORGANIZATION_TERMINATED الشركة لم تعد قائمة "ROLE_ENDED" كما في الأعلى
network.connections[].is_currentboolean true إذا كان الرابط لا يزال قائمًا اليوم. false كما في الأعلى
network.connections[].depthinteger مستوى الرابط: 1 إذا كانت الشركة المطلوبة هي source أو target، و2 للروابط التي تبعد مستوى إضافيًا. 1 كما في الأعلى

الروابط المنتهية مشمولة أيضًا. يُظهر is_current ما إذا كان الرابط لا يزال قائمًا اليوم؛ ويذكر start_date وend_date التواريخ من السجل، حيثما كانت معروفة.

كثير من الروابط من النوع OWNERSHIP إلى الشركة المطلوبة لها أيضًا ownership. وهو يحتوي على ما هو معروف عن الحصة: من قائمة الشركاء النسبة المئوية والمبلغ الاسمي، ومن السجل مثلًا مبلغ مسؤولية الشريك الموصي.

الحقل
الحقل المعنى مثال التوفر
network.connections[].ownershipobject|null لروابط OWNERSHIP إلى الشركة المطلوبة فقط، وليس لجميعها: تفاصيل الحصة. وإلا يغيب الحقل.فارغ عندما لا شيء معروف عن الحصةnetwork · بدءًا من Pro · Beta – نادرًا
network.connections[].ownership.percentagenumber|null الحصة بالنسبة المئوية: 100 تعني 100 %.فارغ عندما الحصة مأخوذة من السجل – كما في الأعلى
network.connections[].ownership.amountobject|null مبلغ مع value وcurrency: المبلغ الاسمي للحصص أو مبلغ مسؤولية الشريك الموصي.فارغ عندما لا يوجد مبلغ معروف – كما في الأعلى
network.connections[].ownership.as_ofstring|null تاريخ قائمة الشركاء التي أُخذت منها الحصة.فارغ عندما الحصة مأخوذة من السجل – كما في الأعلى
network.connections[].ownership.sourcestring من أين تأتي الحصة.القيم: shareholder_list قائمة الشركاء (Gesellschafterliste), commercial_register السجل التجاري (Handelsregister) – كما في الأعلى
نستخرج المشاركات آليًا من قوائم الشركاء ونربطها بالشركات والأشخاص. نستخدم لذلك أحدث التقنيات ونستثمر كثيرًا في الجودة؛ ومع ذلك تبقى أخطاء فردية ممكنة.

العلاقات المباشرة

مع network تحصل أيضًا على القائمة management في المستوى الأعلى من الاستجابة، دون تكلفة إضافية. وهي تلخّص باختصار العلاقات المباشرة الحالية للشركة: الأشخاص في المناصب والشركات المرتبطة بها، مثلًا عبر اندماج أو اتفاقية مؤسسية.

ليس للإدخالات entity_id. للتحليل والطلبات اللاحقة استخدم الروابط في network؛ ولتفاصيل الاندماجات والانقسامات استخدم الميزة الاندماج والاستحواذ.

الحقل
الحقل المعنى مثال التوفر
managementarray العلاقات المباشرة الحالية للشركة كقائمة بسيطة. تأتي مع الميزة network دون تكلفة إضافية.فارغ عندما لا توجد علاقات معروفةnetwork · بدءًا من Pro · Beta – غالبًا
management[].full_namestring اسم الشخص أو الشركة. "Max Felix Mustermann" كما في الأعلى
management[].relation_labelstring نوع العلاقة: منصب أو مشاركة للأشخاص، ورابط بين شركات للشركات. قد تُضاف قيم جديدة.القيم: MANAGING_DIRECTOR مدير (Geschäftsführer), BOARD عضو مجلس الإدارة (Vorstand), BOARD_CHAIR رئيس مجلس الإدارة, PROCURA حامل Prokura (Prokurist), LIQUIDATOR مصفٍّ, INSOLVENCY_ADMINISTRATOR مدير الإعسار, FULLY_LIABLE_PARTNER شريك متضامن بمسؤولية شخصية, LIMITED_PARTNER شريك موصٍ (Kommanditist), PARTNER شريك, OWNER مالك, FULLY_LIABLE_FOR شريك متضامن (Komplementär) في الشركة المذكورة, LIMITED_PARTNER_OF شريك موصٍ في الشركة المذكورة, ENTERPRISE_AGREEMENT_WITH اتفاقية مؤسسية (Unternehmensvertrag), MERGED_INTO اندماج, MERGER_WITH اندماج, ABSORBED اندماج, SPLIT_INTO انقسام, SPLIT_FROM انقسام, SQUEEZED_OUT_BY إقصاء مساهمي الأقلية (squeeze-out), REFERENCE إشارة في قيد السجل, REFERENCED_BY إشارة في قيد السجل "MANAGING_DIRECTOR" كما في الأعلى
management[].labelobject تسمية بـ de وen، واحدة لجميع الإدخالات. أما نوع العلاقة القائمة فتقرؤه من relation_label. – كما في الأعلى
management[].meta.start_datestring|null البداية، حيثما كانت معروفة: للمناصب بالصيغة YYYY-MM-DD، وللتحولات مع الوقت.فارغ عندما لا يوجد تاريخ معروف "2015-07-28" كما في الأعلى
management[].meta.end_datenull نهاية العلاقة. تعرض القائمة العلاقات الحالية، ولذلك تكون القيمة null. null كما في الأعلى
management[].effective_end_datenull نهاية العلاقة. تعرض القائمة العلاقات الحالية، ولذلك تكون القيمة null. null كما في الأعلى
management[].end_reasonnull سبب نهاية العلاقة. تعرض القائمة العلاقات الحالية، ولذلك تكون القيمة null. null كما في الأعلى
management[].meta.lineage_kindstring للروابط بين الشركات فقط: نوع المعاملة.القيم: TRANSFORMATION_MERGER اندماج, TRANSFORMATION_SPLIT انقسام, ENTERPRISE_AGREEMENT اتفاقية مؤسسية, GROUP_ENTERPRISE_AGREEMENT اتفاقية مؤسسية داخل مجموعة, SQUEEZE_OUT إقصاء مساهمي الأقلية (squeeze-out) – نادرًا 
1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "management": [5    {6      "relation_label": "MANAGING_DIRECTOR",7      "label": {8        "de": "Geschäftsführer",9        "en": "Managing Director"10      },11      "full_name": "Max Felix Mustermann",12      "meta": {13        "start_date": "2015-07-28",14        "end_date": null15      },16      "effective_end_date": null,17      "end_reason": null18    },19    {20      "relation_label": "MANAGING_DIRECTOR",21      "label": {22        "de": "Geschäftsführer",23        "en": "Managing Director"24      },25      "full_name": "Paul Musterwald",26      "meta": {27        "start_date": "2019-01-04",28        "end_date": null29      },30      "effective_end_date": null,31      "end_reason": null32    },33    {34      "relation_label": "MANAGING_DIRECTOR",35      "label": {36        "de": "Geschäftsführer",37        "en": "Managing Director"38      },39      "full_name": "Jan Musterhuber",40      "meta": {41        "start_date": "2019-01-04",42        "end_date": null43      },44      "effective_end_date": null,45      "end_reason": null46    }47  ]48}
200 · مثال على استجابة: management لـ Hetzner Online GmbH

شبكة شخص

يقدّم ملف الشخص الميزة نفسها. هناك يكون الشخص في المركز، بالحقول نفسها كما هنا.

الشركاء والمشاركات الحصص وقوائم الشركاء والمستفيدون الحقيقيون بالتفصيل. الأشخاص والتمثيل الإدارة ومجلس الإدارة وProkura في الشركة. fetch-organization نقطة النهاية مع جميع المعاملات والميزات. fetch-person ملف الشخص مع المناصب والمشاركات والشبكة.