Network
How companies and people are connected.
The feature network (Company network) shows how a company is connected to other companies and people: through positions such as managing director or Prokura (registered power of attorney), through shareholdings and through affiliated companies.
The connections come from the Handelsregister (commercial register) and the Gesellschafterlisten (shareholder lists). They reach two levels deep, from the company to its direct contacts and from there one level further.
The feature comes with the Pro and Max plans and is still in beta. It costs 25 credits, but only when the network contains at least one connection. With other plans the API leaves it out without an error.
Structure
The response is a graph. nodes holds the companies and people, connections the connections between them. Both are linked through 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'
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": ["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": "YOUR_API_KEY" }, }); const data = await response.json();
| Field | Meaning | Example | Availability |
|---|---|---|---|
| networkobject|null |
The network around the company: nodes in nodes, connections in connections.Empty when no connections are known for the companynetwork · from Pro · Beta |
– | mostly |
| network.depthinteger | How many levels the network reaches, counted from the company. The company itself is level 0. |
2 |
as above |
| network.truncatedboolean | true if the network is not complete in the response. |
false |
as above |
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}
Connected companies and people
Each node is a company or a person. The requested company is in it with is_root: true and depth: 0, its direct contacts have depth: 1, their contacts depth: 2.
| Field | Meaning | Example | Availability |
|---|---|---|---|
| network.nodesarray |
All companies and people in the network, including the requested company.network · from Pro · Beta |
– | mostly |
| network.nodes[].node_idstring | ID of the node that source and target refer to. For matched companies and people, the same as the entity_id. |
"94eb910fef13f94585c48c263fa446d4" |
as above |
| network.nodes[].entity_idstring|null | ID of the company or person, for its company profile or person profile.Empty when a shareholder is only known from a shareholder list and could not be matched with certainty |
"94eb910fef13f94585c48c263fa446d4" |
as above |
| network.nodes[].typestring |
The kind of node.Values: ORGANIZATION company, PERSON person |
"ORGANIZATION" |
as above |
| network.nodes[].namestring | Name of the company or person. |
"Hetzner Online GmbH" |
as above |
| network.nodes[].depthinteger | Distance to the requested company: 0 is the company itself, 1 a direct contact, 2 a contact of a contact. |
0 |
as above |
| network.nodes[].is_rootboolean | true only for the requested company. |
true |
as above |
| network.nodes[].statusstring|null |
Only for organizations: the current status in the register.Empty when the node is a personValues: ACTIVE active, INACTIVE no longer active, for example deleted or merged |
"ACTIVE" |
as above |
| network.nodes[].registration_statusstring|null |
Register status of the company. Other values are possible; treat unknown values as “not active”.Empty when the node is a personValues: ACTIVE active, TERMINATED deleted from the register |
"ACTIVE" |
as above |
| network.nodes[].cessation_datestring|null | Only for companies that are no longer active: the date on which the company ended, in the format YYYY-MM-DD.Empty when the company is active or the node is a person |
null |
rarely |
| network.nodes[].registration_referencestring|null | Only for nodes without entity_id: the register entry of a company, as it appears in the shareholder list. | – | as above |
| network.nodes[].country_codestring|null | Only for nodes without entity_id: the country of a company as a three-letter ISO code. | – | as above |
| network.nodes[].birth_datestring|null | Only for nodes without entity_id: the date of birth of a person from the shareholder list. | – | as above |
With the entity_id of a node you fetch its company profile or person profile and can follow the network from there.
Reading connections
A connection runs from source to target. The source is the person or company that holds a position, a share or a group link; the target is the company where it exists.
connection_type tells you the kind of connection, label names it exactly. The display labels are in role.de and role.en.
| connection_type | Meaning | Typical values in label |
|---|---|---|
| ROLE | A position at the company | MANAGING_DIRECTOR, BOARD, PROCURA |
| OWNERSHIP | A shareholding in the company | SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER |
| GROUP | An affiliated company | AFFILIATED_COMPANY |
| Field | Meaning | Example | Availability |
|---|---|---|---|
| network.connectionsarray |
All connections between the nodes, current and ended.network · from Pro · Beta |
– | mostly |
| network.connections[].sourceobject | Where the connection starts: entity_id, node_id, type and name. | – | as above |
| network.connections[].targetobject | The company where the position, the share or the link exists, with the same fields. | – | as above |
| network.connections[].connection_typestring |
The kind of connection.Values: ROLE position, OWNERSHIP shareholding, GROUP affiliated company |
"ROLE" |
as above |
| network.connections[].labelstring |
The exact name of the connection. New values can be added.Values: MANAGING_DIRECTOR managing director (Geschäftsführer), BOARD member of the management board (Vorstand), BOARD_CHAIR chair of the management board, DIRECTOR executive director, for example of an SE, PROCURA holder of Prokura (Prokurist), LIQUIDATOR liquidator, INSOLVENCY_ADMINISTRATOR insolvency administrator, REPRESENTATIVE permanent representative, TREASURER treasurer of an association, SECRETARY secretary of an association, OTHER other role, SHAREHOLDER shareholder according to the shareholder list, LIMITED_PARTNER limited partner (Kommanditist), FULLY_LIABLE_PARTNER general partner with personal liability, PARTNER partner, OWNER owner, AFFILIATED_COMPANY affiliated company |
"BOARD" |
as above |
| network.connections[].roleobject | The display label: de and en, each with long and short. | – | as above |
| network.connections[].start_datestring|null | Start according to the register, in the format YYYY-MM-DD.Empty when the register gives no date |
"2002-10-15" |
as above |
| network.connections[].end_datestring|null | End according to the register.Empty when the connection still exists or no date is known |
"2015-07-28" |
as above |
| network.connections[].effective_end_datestring|null | When the connection actually ended: the end_date or, if the register names no end for the connection, the end of the company.Empty when the connection still exists or no date is known |
"2015-07-28" |
as above |
| network.connections[].end_reasonstring|null |
Why the connection no longer exists. New values can be added.Empty when the connection still existsValues: ROLE_ENDED the connection was ended, ORGANIZATION_TERMINATED the company no longer exists |
"ROLE_ENDED" |
as above |
| network.connections[].is_currentboolean | true if the connection still exists today. |
false |
as above |
| network.connections[].depthinteger | The level of the connection: 1 if the requested company is source or target, 2 for connections one level further. |
1 |
as above |
Ended connections are included too. is_current shows whether a connection still exists today; start_date and end_date give the dates from the register, where known.
Many connections of type OWNERSHIP to the requested company also have ownership. It holds what is known about the share: from the shareholder list the percentage and the nominal amount, from the register for example the liability amount of a limited partner.
| Field | Meaning | Example | Availability |
|---|---|---|---|
| network.connections[].ownershipobject|null |
Only for OWNERSHIP connections to the requested company, and not for all of them: details on the share. Otherwise the field is missing.Empty when nothing is known about the sharenetwork · from Pro · Beta |
– | rarely |
| network.connections[].ownership.percentagenumber|null | Share in percent: 100 means 100 %.Empty when the share comes from the register | – | as above |
| network.connections[].ownership.amountobject|null | Amount with value and currency: the nominal amount of the shares or the liability amount of a limited partner.Empty when no amount is known | – | as above |
| network.connections[].ownership.as_ofstring|null | Date of the shareholder list the share comes from.Empty when the share comes from the register | – | as above |
| network.connections[].ownership.sourcestring |
Where the share comes from.Values: shareholder_list shareholder list (Gesellschafterliste), commercial_register commercial register (Handelsregister) |
– | as above |
We extract shareholdings automatically from shareholder lists and link them to companies and people. We use the latest technology for this and invest a lot in quality; individual errors are still possible.
Direct relationships
With network you also get the list management at the top level of the response, at no extra cost. It briefly sums up the company's current direct relationships: people in positions and companies it is linked to, for example through a merger or an enterprise agreement.
The entries have no entity_id. For analysis and follow-up requests, use the connections in network; for details on mergers and splits, use the feature M&A.
| Field | Meaning | Example | Availability |
|---|---|---|---|
| managementarray |
The company's current direct relationships as a simple list. Comes with the feature network at no extra cost.Empty when no relationships are knownnetwork · from Pro · Beta |
– | mostly |
| management[].full_namestring | Name of the person or company. |
"Max Felix Mustermann" |
as above |
| management[].relation_labelstring |
The kind of relationship: a position or a shareholding for people, a link between companies for companies. New values can be added.Values: MANAGING_DIRECTOR managing director (Geschäftsführer), BOARD member of the management board (Vorstand), BOARD_CHAIR chair of the management board, PROCURA holder of Prokura (Prokurist), LIQUIDATOR liquidator, INSOLVENCY_ADMINISTRATOR insolvency administrator, FULLY_LIABLE_PARTNER general partner with personal liability, LIMITED_PARTNER limited partner (Kommanditist), PARTNER partner, OWNER owner, FULLY_LIABLE_FOR general partner (Komplementär) of the named company, LIMITED_PARTNER_OF limited partner of the named company, ENTERPRISE_AGREEMENT_WITH enterprise agreement (Unternehmensvertrag), MERGED_INTO merger, MERGER_WITH merger, ABSORBED merger, SPLIT_INTO split, SPLIT_FROM split, SQUEEZED_OUT_BY squeeze-out, REFERENCE reference in the register entry, REFERENCED_BY reference in the register entry |
"MANAGING_DIRECTOR" |
as above |
| management[].labelobject | A label in de and en, the same for all entries. Which relationship exists, you read from relation_label. | – | as above |
| management[].meta.start_datestring|null | Start, where known: for positions as YYYY-MM-DD, for transformations with a time.Empty when no date is known |
"2015-07-28" |
as above |
| management[].meta.end_datenull | End of the relationship. The list shows current relationships, so this is null. |
null |
as above |
| management[].effective_end_datenull | End of the relationship. The list shows current relationships, so this is null. |
null |
as above |
| management[].end_reasonnull | Reason for the end of the relationship. The list shows current relationships, so this is null. |
null |
as above |
| management[].meta.lineage_kindstring |
Only for links between companies: the kind of transaction.Values: TRANSFORMATION_MERGER merger, TRANSFORMATION_SPLIT split, ENTERPRISE_AGREEMENT enterprise agreement, GROUP_ENTERPRISE_AGREEMENT enterprise agreement within a group, SQUEEZE_OUT squeeze-out |
– | rarely |
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}
Network of a person
The person profile offers the same feature. There the person is at the center, with the same fields as here.
Shareholders and shareholdings
Shares, shareholder lists and beneficial owners in detail.
People and representation
Management, board and Prokura of a company.
fetch-organization
The endpoint with all parameters and features.
fetch-person
The person profile with positions, shareholdings and network.