Rede
Como empresas e pessoas estão ligadas.
O recurso network (Rede da empresa) mostra como uma empresa está ligada a outras empresas e pessoas: por cargos como diretor ou Prokura (procuração comercial registrada), por participações e por empresas coligadas.
As ligações vêm do Handelsregister (registro comercial) e das Gesellschafterlisten (listas de sócios). Elas alcançam dois níveis: da empresa aos seus contatos diretos e, a partir deles, um nível adiante.
O recurso está incluído nos planos Pro e Max e ainda está em beta. Ele custa 25 créditos, mas só quando a rede contém pelo menos uma ligação. Com outros planos, a API o omite sem erro.
Estrutura
A resposta é um grafo. nodes contém as empresas e pessoas, connections as ligações entre elas. Os dois estão conectados por node_id.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: SUA_CHAVE_DE_API" \ --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": "SUA_CHAVE_DE_API"}, 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": "SUA_CHAVE_DE_API" }, }); const data = await response.json();
| Campo | Significado | Exemplo | Disponibilidade |
|---|---|---|---|
| networkobject|null |
A rede em torno da empresa: nós em nodes, ligações em connections.Vazio quando não há ligações conhecidas para a empresanetwork · a partir de Pro · Beta |
– | geralmente |
| network.depthinteger | Quantos níveis a rede alcança, contados a partir da empresa. A própria empresa é o nível 0. |
2 |
como acima |
| network.truncatedboolean | true se a rede não está completa na resposta. |
false |
como acima |
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}
Empresas e pessoas ligadas
Cada nó é uma empresa ou uma pessoa. A empresa consultada está nele com is_root: true e depth: 0, seus contatos diretos têm depth: 1, os contatos deles depth: 2.
| Campo | Significado | Exemplo | Disponibilidade |
|---|---|---|---|
| network.nodesarray |
Todas as empresas e pessoas da rede, incluindo a empresa consultada.network · a partir de Pro · Beta |
– | geralmente |
| network.nodes[].node_idstring | ID do nó ao qual source e target se referem. Para empresas e pessoas identificadas, igual ao entity_id. |
"94eb910fef13f94585c48c263fa446d4" |
como acima |
| network.nodes[].entity_idstring|null | ID da empresa ou pessoa, para o seu perfil da empresa ou perfil de pessoa.Vazio quando um sócio só é conhecido por uma lista de sócios e não pôde ser identificado com segurança |
"94eb910fef13f94585c48c263fa446d4" |
como acima |
| network.nodes[].typestring |
O tipo de nó.Valores: ORGANIZATION empresa, PERSON pessoa |
"ORGANIZATION" |
como acima |
| network.nodes[].namestring | Nome da empresa ou pessoa. |
"Hetzner Online GmbH" |
como acima |
| network.nodes[].depthinteger | Distância até a empresa consultada: 0 é a própria empresa, 1 um contato direto, 2 um contato de um contato. |
0 |
como acima |
| network.nodes[].is_rootboolean | true apenas para a empresa consultada. |
true |
como acima |
| network.nodes[].statusstring|null |
Só para organizações: a situação atual no registro.Vazio quando o nó é uma pessoaValores: ACTIVE ativa, INACTIVE não mais ativa, por exemplo cancelada ou incorporada |
"ACTIVE" |
como acima |
| network.nodes[].registration_statusstring|null |
Situação da empresa no registro. Outros valores são possíveis; trate valores desconhecidos como “não ativa”.Vazio quando o nó é uma pessoaValores: ACTIVE ativa, TERMINATED cancelada no registro |
"ACTIVE" |
como acima |
| network.nodes[].cessation_datestring|null | Só para empresas que não estão mais ativas: a data em que a empresa deixou de existir, no formato YYYY-MM-DD.Vazio quando a empresa está ativa ou o nó é uma pessoa |
null |
raramente |
| network.nodes[].registration_referencestring|null | Só para nós sem entity_id: o registro de uma empresa, como aparece na lista de sócios. | – | como acima |
| network.nodes[].country_codestring|null | Só para nós sem entity_id: o país de uma empresa como código ISO de três letras. | – | como acima |
| network.nodes[].birth_datestring|null | Só para nós sem entity_id: a data de nascimento de uma pessoa, da lista de sócios. | – | como acima |
Com o entity_id de um nó, você obtém o perfil da empresa ou o perfil de pessoa correspondente e pode seguir a rede a partir dali.
Ler as ligações
Uma ligação vai de source para target. A origem é a pessoa ou empresa que tem um cargo, uma participação ou um vínculo de grupo; o destino é a empresa onde isso existe.
connection_type informa o tipo de ligação, label a nomeia com exatidão. Os textos para exibição estão em role.de e role.en.
| connection_type | Significado | Valores típicos em label |
|---|---|---|
| ROLE | Um cargo na empresa | MANAGING_DIRECTOR, BOARD, PROCURA |
| OWNERSHIP | Uma participação na empresa | SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER |
| GROUP | Uma empresa coligada | AFFILIATED_COMPANY |
| Campo | Significado | Exemplo | Disponibilidade |
|---|---|---|---|
| network.connectionsarray |
Todas as ligações entre os nós, atuais e encerradas.network · a partir de Pro · Beta |
– | geralmente |
| network.connections[].sourceobject | Onde a ligação começa: entity_id, node_id, type e name. | – | como acima |
| network.connections[].targetobject | A empresa onde existe o cargo, a participação ou o vínculo, com os mesmos campos. | – | como acima |
| network.connections[].connection_typestring |
O tipo de ligação.Valores: ROLE cargo, OWNERSHIP participação, GROUP empresa coligada |
"ROLE" |
como acima |
| network.connections[].labelstring |
O nome exato da ligação. Novos valores podem ser acrescentados.Valores: MANAGING_DIRECTOR diretor (Geschäftsführer), BOARD membro da diretoria executiva (Vorstand), BOARD_CHAIR presidente da diretoria executiva, DIRECTOR diretor executivo, por exemplo de uma SE, PROCURA titular de Prokura (Prokurist), LIQUIDATOR liquidante, INSOLVENCY_ADMINISTRATOR administrador judicial da insolvência, REPRESENTATIVE representante permanente, TREASURER tesoureiro de uma associação, SECRETARY secretário de uma associação, OTHER outra função, SHAREHOLDER sócio segundo a lista de sócios, LIMITED_PARTNER sócio comanditário (Kommanditist), FULLY_LIABLE_PARTNER sócio com responsabilidade pessoal ilimitada, PARTNER sócio, OWNER proprietário, AFFILIATED_COMPANY empresa coligada |
"BOARD" |
como acima |
| network.connections[].roleobject | O texto para exibição: de e en, cada um com long e short. | – | como acima |
| network.connections[].start_datestring|null | Início segundo o registro, no formato YYYY-MM-DD.Vazio quando o registro não informa data |
"2002-10-15" |
como acima |
| network.connections[].end_datestring|null | Fim segundo o registro.Vazio quando a ligação ainda existe ou nenhuma data é conhecida |
"2015-07-28" |
como acima |
| network.connections[].effective_end_datestring|null | Quando a ligação realmente terminou: end_date ou, se o registro não indica um fim para a ligação, o fim da empresa.Vazio quando a ligação ainda existe ou nenhuma data é conhecida |
"2015-07-28" |
como acima |
| network.connections[].end_reasonstring|null |
Por que a ligação não existe mais. Novos valores podem ser acrescentados.Vazio quando a ligação ainda existeValores: ROLE_ENDED a ligação foi encerrada, ORGANIZATION_TERMINATED a empresa não existe mais |
"ROLE_ENDED" |
como acima |
| network.connections[].is_currentboolean | true se a ligação ainda existe hoje. |
false |
como acima |
| network.connections[].depthinteger | O nível da ligação: 1 se a empresa consultada é source ou target, 2 para ligações um nível adiante. |
1 |
como acima |
Ligações encerradas também estão incluídas. is_current mostra se uma ligação ainda existe hoje; start_date e end_date trazem as datas do registro, quando conhecidas.
Muitas ligações do tipo OWNERSHIP com a empresa consultada também têm ownership. Ele contém o que se sabe sobre a participação: da lista de sócios, o percentual e o valor nominal; do registro, por exemplo, o valor de responsabilidade de um sócio comanditário.
| Campo | Significado | Exemplo | Disponibilidade |
|---|---|---|---|
| network.connections[].ownershipobject|null |
Só para ligações OWNERSHIP com a empresa consultada, e não para todas: detalhes da participação. Caso contrário, o campo não aparece.Vazio quando nada se sabe sobre a participaçãonetwork · a partir de Pro · Beta |
– | raramente |
| network.connections[].ownership.percentagenumber|null | Participação em percentual: 100 significa 100 %.Vazio quando a participação vem do registro | – | como acima |
| network.connections[].ownership.amountobject|null | Valor com value e currency: o valor nominal das quotas ou o valor de responsabilidade de um sócio comanditário.Vazio quando nenhum valor é conhecido | – | como acima |
| network.connections[].ownership.as_ofstring|null | Data da lista de sócios de onde vem a participação.Vazio quando a participação vem do registro | – | como acima |
| network.connections[].ownership.sourcestring |
De onde vem a participação.Valores: shareholder_list lista de sócios (Gesellschafterliste), commercial_register registro comercial (Handelsregister) |
– | como acima |
Extraímos participações automaticamente das listas de sócios e as associamos a empresas e pessoas. Usamos a tecnologia mais recente para isso e investimos muito em qualidade; ainda assim, erros pontuais são possíveis.
Relações diretas
Com network, você também recebe a lista management no nível superior da resposta, sem custo adicional. Ela resume brevemente as relações diretas atuais da empresa: pessoas em cargos e empresas às quais ela está vinculada, por exemplo por uma fusão ou um contrato de empresa.
As entradas não têm entity_id. Para análises e requisições seguintes, use as ligações em network; para detalhes sobre fusões e cisões, use o recurso Fusões e aquisições.
| Campo | Significado | Exemplo | Disponibilidade |
|---|---|---|---|
| managementarray |
As relações diretas atuais da empresa, como lista simples. Vem com o recurso network sem custo adicional.Vazio quando nenhuma relação é conhecidanetwork · a partir de Pro · Beta |
– | geralmente |
| management[].full_namestring | Nome da pessoa ou empresa. |
"Max Felix Mustermann" |
como acima |
| management[].relation_labelstring |
O tipo de relação: para pessoas, um cargo ou uma participação; para empresas, um vínculo entre empresas. Novos valores podem ser acrescentados.Valores: MANAGING_DIRECTOR diretor (Geschäftsführer), BOARD membro da diretoria executiva (Vorstand), BOARD_CHAIR presidente da diretoria executiva, PROCURA titular de Prokura (Prokurist), LIQUIDATOR liquidante, INSOLVENCY_ADMINISTRATOR administrador judicial da insolvência, FULLY_LIABLE_PARTNER sócio com responsabilidade pessoal ilimitada, LIMITED_PARTNER sócio comanditário (Kommanditist), PARTNER sócio, OWNER proprietário, FULLY_LIABLE_FOR sócio de responsabilidade ilimitada (Komplementär) da empresa indicada, LIMITED_PARTNER_OF sócio comanditário da empresa indicada, ENTERPRISE_AGREEMENT_WITH contrato de empresa (Unternehmensvertrag), MERGED_INTO fusão, MERGER_WITH fusão, ABSORBED fusão, SPLIT_INTO cisão, SPLIT_FROM cisão, SQUEEZED_OUT_BY squeeze-out, REFERENCE referência no registro, REFERENCED_BY referência no registro |
"MANAGING_DIRECTOR" |
como acima |
| management[].labelobject | Um rótulo em de e en, igual para todas as entradas. Qual relação existe, você lê em relation_label. | – | como acima |
| management[].meta.start_datestring|null | Início, quando conhecido: para cargos como YYYY-MM-DD, para transformações com horário.Vazio quando nenhuma data é conhecida |
"2015-07-28" |
como acima |
| management[].meta.end_datenull | Fim da relação. A lista mostra relações atuais, então isto é null. |
null |
como acima |
| management[].effective_end_datenull | Fim da relação. A lista mostra relações atuais, então isto é null. |
null |
como acima |
| management[].end_reasonnull | Motivo do fim da relação. A lista mostra relações atuais, então isto é null. |
null |
como acima |
| management[].meta.lineage_kindstring |
Só para vínculos entre empresas: o tipo de operação.Valores: TRANSFORMATION_MERGER fusão, TRANSFORMATION_SPLIT cisão, ENTERPRISE_AGREEMENT contrato de empresa, GROUP_ENTERPRISE_AGREEMENT contrato de empresa dentro de um grupo, SQUEEZE_OUT squeeze-out |
– | raramente |
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}
Rede de uma pessoa
O perfil de pessoa oferece o mesmo recurso. Lá a pessoa fica no centro, com os mesmos campos daqui.