Netzwerk
Wie Firmen und Personen miteinander verbunden sind.
Das Feature network (Firmen-Netzwerk) zeigt, wie eine Firma mit anderen Firmen und Personen verbunden ist: über Ämter wie Geschäftsführung oder Prokura, über Beteiligungen und über verbundene Unternehmen.
Die Verbindungen stammen aus dem Handelsregister und den Gesellschafterlisten. Sie reichen zwei Ebenen weit, von der Firma zu ihren direkten Kontakten und von dort eine Ebene weiter.
Das Feature gibt es mit den Credit-Abos Pro und Max, es ist noch in der Beta. Es kostet 25 Credits, aber nur, wenn das Netzwerk mindestens eine Verbindung enthält. Mit anderen Credit-Abos lässt die API es ohne Fehler weg.
Aufbau
Die Antwort ist ein Graph. nodes enthält die Firmen und Personen, connections die Verbindungen zwischen ihnen. Beide hängen über node_id zusammen.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'q=Hetzner Online GmbH' \ --data-urlencode 'feature=network'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "q": "Hetzner Online GmbH", "feature": ["network"], }, ) 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", "network"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
| Feld | Bedeutung | Beispiel | Verfügbarkeit |
|---|---|---|---|
| networkobject|null |
Das Netzwerk rund um die Firma: Knoten in nodes, Verbindungen in connections.Leer, wenn für die Firma keine Verbindungen bekannt sindnetwork · ab Pro · Beta |
– | meist |
| network.depthinteger | Bis zu welcher Ebene das Netzwerk reicht, gezählt ab der Firma. Die Firma selbst ist Ebene 0. |
2 |
wie oben |
| network.truncatedboolean | true, wenn das Netzwerk nicht vollständig in der Antwort steht. |
false |
wie oben |
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}
Verbundene Firmen und Personen
Jeder Knoten ist eine Firma oder eine Person. Die abgefragte Firma steht mit is_root: true und depth: 0 darin, ihre direkten Kontakte haben depth: 1, deren Kontakte depth: 2.
| Feld | Bedeutung | Beispiel | Verfügbarkeit |
|---|---|---|---|
| network.nodesarray |
Alle Firmen und Personen im Netzwerk, die abgefragte Firma eingeschlossen.network · ab Pro · Beta |
– | meist |
| network.nodes[].node_idstring | Kennung des Knotens, auf die source und target verweisen. Bei zugeordneten Firmen und Personen gleich der entity_id. |
"94eb910fef13f94585c48c263fa446d4" |
wie oben |
| network.nodes[].entity_idstring|null | ID der Firma oder Person, für ihr Firmenprofil oder Personenprofil.Leer, wenn ein Gesellschafter nur aus einer Gesellschafterliste bekannt ist und nicht sicher zugeordnet werden konnte |
"94eb910fef13f94585c48c263fa446d4" |
wie oben |
| network.nodes[].typestring |
Die Art des Knotens.Werte: ORGANIZATION Firma, PERSON Person |
"ORGANIZATION" |
wie oben |
| network.nodes[].namestring | Name der Firma oder Person. |
"Hetzner Online GmbH" |
wie oben |
| network.nodes[].depthinteger | Abstand zur abgefragten Firma: 0 ist die Firma selbst, 1 ein direkter Kontakt, 2 ein Kontakt eines Kontakts. |
0 |
wie oben |
| network.nodes[].is_rootboolean | true nur bei der abgefragten Firma. |
true |
wie oben |
| network.nodes[].statusstring|null |
Nur bei Organisationen: der aktuelle Status im Register.Leer, wenn der Knoten eine Person istWerte: ACTIVE aktiv, INACTIVE nicht mehr aktiv, etwa gelöscht oder verschmolzen |
"ACTIVE" |
wie oben |
| network.nodes[].registration_statusstring|null |
Registerstatus der Firma. Weitere Werte sind möglich; behandle unbekannte Werte als „nicht aktiv“.Leer, wenn der Knoten eine Person istWerte: ACTIVE aktiv, TERMINATED im Register gelöscht |
"ACTIVE" |
wie oben |
| network.nodes[].cessation_datestring|null | Nur bei Firmen, die nicht mehr aktiv sind: das Datum, an dem die Firma endete, im Format JJJJ-MM-TT.Leer, wenn die Firma aktiv ist oder der Knoten eine Person ist |
null |
selten |
| network.nodes[].registration_referencestring|null | Nur bei Knoten ohne entity_id: der Registereintrag einer Firma, so wie er in der Gesellschafterliste steht. | – | wie oben |
| network.nodes[].country_codestring|null | Nur bei Knoten ohne entity_id: das Land einer Firma als dreistelliger ISO-Code. | – | wie oben |
| network.nodes[].birth_datestring|null | Nur bei Knoten ohne entity_id: das Geburtsdatum einer Person aus der Gesellschafterliste. | – | wie oben |
Mit der entity_id eines Knotens rufst du sein Firmenprofil oder Personenprofil ab und kannst das Netzwerk von dort aus weiter verfolgen.
Verbindungen lesen
Eine Verbindung führt von source zu target. Die Quelle ist die Person oder Firma, die ein Amt, einen Anteil oder eine Konzernverbindung hat; das Ziel ist die Firma, bei der sie besteht.
connection_type sagt, welche Art von Verbindung es ist, label nennt sie genau. Die Bezeichnungen zum Anzeigen stehen in role.de und role.en.
| connection_type | Bedeutung | Typische Werte in label |
|---|---|---|
| ROLE | Ein Amt bei der Firma | MANAGING_DIRECTOR, BOARD, PROCURA |
| OWNERSHIP | Eine Beteiligung an der Firma | SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER |
| GROUP | Ein verbundenes Unternehmen | AFFILIATED_COMPANY |
| Feld | Bedeutung | Beispiel | Verfügbarkeit |
|---|---|---|---|
| network.connectionsarray |
Alle Verbindungen zwischen den Knoten, aktuelle und beendete.network · ab Pro · Beta |
– | meist |
| network.connections[].sourceobject | Von wem die Verbindung ausgeht: entity_id, node_id, type und name. | – | wie oben |
| network.connections[].targetobject | Die Firma, bei der das Amt, der Anteil oder die Verbindung besteht, mit denselben Feldern. | – | wie oben |
| network.connections[].connection_typestring |
Die Art der Verbindung.Werte: ROLE Amt, OWNERSHIP Beteiligung, GROUP verbundenes Unternehmen |
"ROLE" |
wie oben |
| network.connections[].labelstring |
Die Verbindung genau benannt. Neue Werte können hinzukommen.Werte: MANAGING_DIRECTOR Geschäftsführer, BOARD Vorstandsmitglied, BOARD_CHAIR Vorsitz des Vorstands, DIRECTOR geschäftsführender Direktor, etwa einer SE, PROCURA Prokurist, LIQUIDATOR Liquidator, INSOLVENCY_ADMINISTRATOR Insolvenzverwalter, REPRESENTATIVE ständiger Vertreter, TREASURER Kassenwart eines Vereins, SECRETARY Schriftführer eines Vereins, OTHER andere Rolle, SHAREHOLDER Gesellschafter laut Gesellschafterliste, LIMITED_PARTNER Kommanditist, FULLY_LIABLE_PARTNER persönlich haftender Gesellschafter, PARTNER Partner oder Gesellschafter, OWNER Inhaber, AFFILIATED_COMPANY verbundenes Unternehmen |
"BOARD" |
wie oben |
| network.connections[].roleobject | Die Bezeichnung zum Anzeigen: de und en, je mit long und short. | – | wie oben |
| network.connections[].start_datestring|null | Beginn laut Register, im Format JJJJ-MM-TT.Leer, wenn das Register kein Datum nennt |
"2002-10-15" |
wie oben |
| network.connections[].end_datestring|null | Ende laut Register.Leer, wenn die Verbindung noch besteht oder kein Datum bekannt ist |
"2015-07-28" |
wie oben |
| network.connections[].effective_end_datestring|null | Wann die Verbindung tatsächlich endete: das end_date oder, wenn das Register für die Verbindung kein Ende nennt, das Ende der Firma.Leer, wenn die Verbindung noch besteht oder kein Datum bekannt ist |
"2015-07-28" |
wie oben |
| network.connections[].end_reasonstring|null |
Warum die Verbindung nicht mehr besteht. Neue Werte können hinzukommen.Leer, wenn die Verbindung noch bestehtWerte: ROLE_ENDED die Verbindung wurde beendet, ORGANIZATION_TERMINATED die Firma besteht nicht mehr |
"ROLE_ENDED" |
wie oben |
| network.connections[].is_currentboolean | true, wenn die Verbindung heute noch besteht. |
false |
wie oben |
| network.connections[].depthinteger | Die Ebene der Verbindung: 1, wenn die abgefragte Firma Quelle oder Ziel ist, 2 bei Verbindungen eine Ebene weiter. |
1 |
wie oben |
Auch beendete Verbindungen sind enthalten. is_current zeigt, ob eine Verbindung heute noch besteht; start_date und end_date nennen die Daten aus dem Register, soweit bekannt.
Viele Verbindungen vom Typ OWNERSHIP zur abgefragten Firma haben zusätzlich ownership. Dort steht, was über den Anteil bekannt ist: aus der Gesellschafterliste der Prozentsatz und der Nennbetrag, aus dem Register etwa die Haftsumme eines Kommanditisten.
| Feld | Bedeutung | Beispiel | Verfügbarkeit |
|---|---|---|---|
| network.connections[].ownershipobject|null |
Nur bei OWNERSHIP-Verbindungen zur abgefragten Firma, und dort nicht bei allen: Angaben zum Anteil. Sonst fehlt das Feld.Leer, wenn zum Anteil nichts bekannt istnetwork · ab Pro · Beta |
– | selten |
| network.connections[].ownership.percentagenumber|null | Anteil in Prozent: 100 bedeutet 100 %.Leer, wenn der Anteil aus dem Register stammt | – | wie oben |
| network.connections[].ownership.amountobject|null | Betrag mit value und currency: der Nennbetrag der Anteile oder die Haftsumme eines Kommanditisten.Leer, wenn kein Betrag bekannt ist | – | wie oben |
| network.connections[].ownership.as_ofstring|null | Datum der Gesellschafterliste, aus der der Anteil stammt.Leer, wenn der Anteil aus dem Register stammt | – | wie oben |
| network.connections[].ownership.sourcestring |
Woher der Anteil stammt.Werte: shareholder_list Gesellschafterliste, commercial_register Handelsregister |
– | wie oben |
Beteiligungen lesen wir maschinell aus Gesellschafterlisten und verknüpfen sie mit Firmen und Personen. Wir setzen dafür die neueste Technik ein und investieren viel in die Qualität; einzelne Fehler sind trotzdem möglich.
Direkte Beziehungen
Mit network kommt die Liste management auf oberster Ebene der Antwort mit, ohne eigene Kosten. Sie fasst die aktuellen direkten Beziehungen der Firma kurz zusammen: Personen in Ämtern und Firmen, mit denen sie etwa durch eine Verschmelzung oder einen Unternehmensvertrag verbunden ist.
Die Einträge haben keine entity_id. Für Auswertungen und Folgeabfragen nutzt du die Verbindungen in network; für Details zu Verschmelzungen und Spaltungen das Feature Fusionen & Übernahmen.
| Feld | Bedeutung | Beispiel | Verfügbarkeit |
|---|---|---|---|
| managementarray |
Die aktuellen direkten Beziehungen der Firma als einfache Liste. Kommt mit dem Feature network ohne eigene Kosten.Leer, wenn keine Beziehungen bekannt sindnetwork · ab Pro · Beta |
– | meist |
| management[].full_namestring | Name der Person oder Firma. |
"Max Felix Mustermann" |
wie oben |
| management[].relation_labelstring |
Die Art der Beziehung: ein Amt oder eine Beteiligung bei Personen, eine Verbindung zwischen Firmen bei Firmen. Neue Werte können hinzukommen.Werte: MANAGING_DIRECTOR Geschäftsführer, BOARD Vorstandsmitglied, BOARD_CHAIR Vorsitz des Vorstands, PROCURA Prokurist, LIQUIDATOR Liquidator, INSOLVENCY_ADMINISTRATOR Insolvenzverwalter, FULLY_LIABLE_PARTNER persönlich haftender Gesellschafter, LIMITED_PARTNER Kommanditist, PARTNER Partner, OWNER Inhaber, FULLY_LIABLE_FOR Komplementär-Beziehung zur genannten Firma, LIMITED_PARTNER_OF Kommandit-Beziehung zur genannten Firma, ENTERPRISE_AGREEMENT_WITH Unternehmensvertrag, MERGED_INTO Verschmelzung, MERGER_WITH Verschmelzung, ABSORBED Verschmelzung, SPLIT_INTO Spaltung, SPLIT_FROM Spaltung, SQUEEZED_OUT_BY Squeeze-out, REFERENCE Verweis im Registereintrag, REFERENCED_BY Verweis im Registereintrag |
"MANAGING_DIRECTOR" |
wie oben |
| management[].labelobject | Eine Beschriftung in de und en, für alle Einträge gleich. Welche Beziehung besteht, liest du an relation_label ab. | – | wie oben |
| management[].meta.start_datestring|null | Beginn, soweit bekannt: bei Ämtern als JJJJ-MM-TT, bei Umwandlungen mit Uhrzeit.Leer, wenn kein Datum bekannt ist |
"2015-07-28" |
wie oben |
| management[].meta.end_datenull | Ende der Beziehung. Die Liste zeigt aktuelle Beziehungen, daher steht hier null. |
null |
wie oben |
| management[].effective_end_datenull | Ende der Beziehung. Die Liste zeigt aktuelle Beziehungen, daher steht hier null. |
null |
wie oben |
| management[].end_reasonnull | Grund für das Ende der Beziehung. Die Liste zeigt aktuelle Beziehungen, daher steht hier null. |
null |
wie oben |
| management[].meta.lineage_kindstring |
Nur bei Verbindungen zwischen Firmen: die Art des Vorgangs.Werte: TRANSFORMATION_MERGER Verschmelzung, TRANSFORMATION_SPLIT Spaltung, ENTERPRISE_AGREEMENT Unternehmensvertrag, GROUP_ENTERPRISE_AGREEMENT Unternehmensvertrag im Konzern, SQUEEZE_OUT Squeeze-out |
– | selten |
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}
Netzwerk einer Person
Das Personenprofil bietet dasselbe Feature. Dort steht die Person in der Mitte, mit denselben Feldern wie hier.
Gesellschafter und Beteiligungen
Anteile, Gesellschafterlisten und wirtschaftlich Berechtigte im Detail.
Personen und Vertretung
Geschäftsführung, Vorstand und Prokura einer Firma.
fetch-organization
Der Endpunkt mit allen Parametern und Features.
fetch-person
Das Personenprofil mit Ämtern, Beteiligungen und Netzwerk.