Red
Cómo se conectan empresas y personas.
La función network (Red de empresas) muestra cómo está conectada una empresa con otras empresas y personas: mediante cargos como administrador o Prokura (poder general mercantil inscrito), mediante participaciones y mediante empresas vinculadas.
Las conexiones proceden del Handelsregister (Registro Mercantil) y de las Gesellschafterlisten (listas de socios). Llegan a dos niveles de profundidad, de la empresa a sus contactos directos y desde ahí un nivel más.
La función viene con los planes Pro y Max y aún está en beta. Cuesta 25 créditos, pero solo cuando la red contiene al menos una conexión. Con otros planes, la API la omite sin error.
Estructura
La respuesta es un grafo. nodes contiene las empresas y personas, connections las conexiones entre ellas. Ambos se enlazan mediante node_id.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_API" }, }); const data = await response.json();
| Campo | Significado | Ejemplo | Disponibilidad |
|---|---|---|---|
| networkobject|null |
La red alrededor de la empresa: nodos en nodes, conexiones en connections.Vacío cuando no se conocen conexiones de la empresanetwork · desde Pro · Beta |
– | casi siempre |
| network.depthinteger | Cuántos niveles alcanza la red, contados desde la empresa. La propia empresa es el nivel 0. |
2 |
como arriba |
| network.truncatedboolean | true si la red no está completa en la respuesta. |
false |
como arriba |
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 y personas conectadas
Cada nodo es una empresa o una persona. La empresa solicitada figura con is_root: true y depth: 0, sus contactos directos tienen depth: 1, los contactos de estos depth: 2.
| Campo | Significado | Ejemplo | Disponibilidad |
|---|---|---|---|
| network.nodesarray |
Todas las empresas y personas de la red, incluida la empresa solicitada.network · desde Pro · Beta |
– | casi siempre |
| network.nodes[].node_idstring | ID del nodo al que se refieren source y target. En empresas y personas asignadas, igual que la entity_id. |
"94eb910fef13f94585c48c263fa446d4" |
como arriba |
| network.nodes[].entity_idstring|null | ID de la empresa o persona, para su perfil de empresa o perfil de persona.Vacío cuando un socio solo se conoce por una lista de socios y no se pudo asignar con seguridad |
"94eb910fef13f94585c48c263fa446d4" |
como arriba |
| network.nodes[].typestring |
El tipo de nodo.Valores: ORGANIZATION empresa, PERSON persona |
"ORGANIZATION" |
como arriba |
| network.nodes[].namestring | Nombre de la empresa o persona. |
"Hetzner Online GmbH" |
como arriba |
| network.nodes[].depthinteger | Distancia a la empresa solicitada: 0 es la propia empresa, 1 un contacto directo, 2 un contacto de un contacto. |
0 |
como arriba |
| network.nodes[].is_rootboolean | true solo para la empresa solicitada. |
true |
como arriba |
| network.nodes[].statusstring|null |
Solo en organizaciones: el estado actual en el registro.Vacío cuando el nodo es una personaValores: ACTIVE activa, INACTIVE ya no activa, por ejemplo cancelada o fusionada |
"ACTIVE" |
como arriba |
| network.nodes[].registration_statusstring|null |
Estado registral de la empresa. Son posibles otros valores; trata los valores desconocidos como “no activa”.Vacío cuando el nodo es una personaValores: ACTIVE activa, TERMINATED cancelada en el registro |
"ACTIVE" |
como arriba |
| network.nodes[].cessation_datestring|null | Solo en empresas que ya no están activas: la fecha en que la empresa dejó de existir, en el formato YYYY-MM-DD.Vacío cuando la empresa está activa o el nodo es una persona |
null |
rara vez |
| network.nodes[].registration_referencestring|null | Solo en nodos sin entity_id: la inscripción registral de una empresa, tal como figura en la lista de socios. | – | como arriba |
| network.nodes[].country_codestring|null | Solo en nodos sin entity_id: el país de una empresa como código ISO de tres letras. | – | como arriba |
| network.nodes[].birth_datestring|null | Solo en nodos sin entity_id: la fecha de nacimiento de una persona según la lista de socios. | – | como arriba |
Con la entity_id de un nodo obtienes su perfil de empresa o perfil de persona y puedes seguir la red desde ahí.
Leer las conexiones
Una conexión va de source a target. El origen es la persona o empresa que tiene un cargo, una participación o un vínculo de grupo; el destino es la empresa en la que existe.
connection_type te indica el tipo de conexión, label la nombra con exactitud. Las etiquetas para mostrar están en role.de y role.en.
| connection_type | Significado | Valores habituales en label |
|---|---|---|
| ROLE | Un cargo en la empresa | MANAGING_DIRECTOR, BOARD, PROCURA |
| OWNERSHIP | Una participación en la empresa | SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER |
| GROUP | Una empresa vinculada | AFFILIATED_COMPANY |
| Campo | Significado | Ejemplo | Disponibilidad |
|---|---|---|---|
| network.connectionsarray |
Todas las conexiones entre los nodos, actuales y terminadas.network · desde Pro · Beta |
– | casi siempre |
| network.connections[].sourceobject | Dónde empieza la conexión: entity_id, node_id, type y name. | – | como arriba |
| network.connections[].targetobject | La empresa en la que existe el cargo, la participación o el vínculo, con los mismos campos. | – | como arriba |
| network.connections[].connection_typestring |
El tipo de conexión.Valores: ROLE cargo, OWNERSHIP participación, GROUP empresa vinculada |
"ROLE" |
como arriba |
| network.connections[].labelstring |
El nombre exacto de la conexión. Pueden añadirse valores nuevos.Valores: MANAGING_DIRECTOR administrador (Geschäftsführer), BOARD miembro del consejo de dirección (Vorstand), BOARD_CHAIR presidencia del consejo de dirección, DIRECTOR director ejecutivo, por ejemplo de una SE, PROCURA apoderado con Prokura (Prokurist), LIQUIDATOR liquidador, INSOLVENCY_ADMINISTRATOR administrador concursal, REPRESENTATIVE representante permanente, TREASURER tesorero de una asociación, SECRETARY secretario de una asociación, OTHER otro cargo, SHAREHOLDER socio según la lista de socios, LIMITED_PARTNER socio comanditario (Kommanditist), FULLY_LIABLE_PARTNER socio colectivo con responsabilidad personal, PARTNER socio, OWNER titular, AFFILIATED_COMPANY empresa vinculada |
"BOARD" |
como arriba |
| network.connections[].roleobject | La etiqueta para mostrar: de y en, cada uno con long y short. | – | como arriba |
| network.connections[].start_datestring|null | Inicio según el registro, en el formato YYYY-MM-DD.Vacío cuando el registro no indica fecha |
"2002-10-15" |
como arriba |
| network.connections[].end_datestring|null | Fin según el registro.Vacío cuando la conexión sigue existiendo o no se conoce fecha |
"2015-07-28" |
como arriba |
| network.connections[].effective_end_datestring|null | Cuándo terminó realmente la conexión: end_date o, si el registro no indica un fin para la conexión, el fin de la empresa.Vacío cuando la conexión sigue existiendo o no se conoce fecha |
"2015-07-28" |
como arriba |
| network.connections[].end_reasonstring|null |
Por qué la conexión ya no existe. Pueden añadirse valores nuevos.Vacío cuando la conexión sigue existiendoValores: ROLE_ENDED la conexión finalizó, ORGANIZATION_TERMINATED la empresa ya no existe |
"ROLE_ENDED" |
como arriba |
| network.connections[].is_currentboolean | true si la conexión sigue existiendo hoy. |
false |
como arriba |
| network.connections[].depthinteger | El nivel de la conexión: 1 si la empresa solicitada es source o target, 2 para conexiones un nivel más allá. |
1 |
como arriba |
Las conexiones terminadas también se incluyen. is_current muestra si una conexión sigue existiendo hoy; start_date y end_date dan las fechas del registro, si se conocen.
Muchas conexiones de tipo OWNERSHIP con la empresa solicitada tienen además ownership. Contiene lo que se sabe de la participación: de la lista de socios, el porcentaje y el importe nominal; del registro, por ejemplo, la suma de responsabilidad de un socio comanditario.
| Campo | Significado | Ejemplo | Disponibilidad |
|---|---|---|---|
| network.connections[].ownershipobject|null |
Solo en conexiones OWNERSHIP con la empresa solicitada, y no en todas: datos sobre la participación. Si no, el campo falta.Vacío cuando no se sabe nada de la participaciónnetwork · desde Pro · Beta |
– | rara vez |
| network.connections[].ownership.percentagenumber|null | Participación en porcentaje: 100 significa 100 %.Vacío cuando la participación procede del registro | – | como arriba |
| network.connections[].ownership.amountobject|null | Importe con value y currency: el importe nominal de las participaciones o la suma de responsabilidad de un socio comanditario.Vacío cuando no se conoce ningún importe | – | como arriba |
| network.connections[].ownership.as_ofstring|null | Fecha de la lista de socios de la que procede la participación.Vacío cuando la participación procede del registro | – | como arriba |
| network.connections[].ownership.sourcestring |
De dónde procede la participación.Valores: shareholder_list lista de socios (Gesellschafterliste), commercial_register Registro Mercantil (Handelsregister) |
– | como arriba |
Extraemos automáticamente las participaciones de las listas de socios y las vinculamos con empresas y personas. Para ello usamos la tecnología más actual e invertimos mucho en calidad; aun así, pueden darse errores puntuales.
Relaciones directas
Con network obtienes además la lista management en el nivel superior de la respuesta, sin coste adicional. Resume brevemente las relaciones directas actuales de la empresa: personas con cargos y empresas con las que está vinculada, por ejemplo mediante una fusión o un contrato entre empresas.
Las entradas no tienen entity_id. Para análisis y solicitudes posteriores, usa las conexiones de network; para detalles sobre fusiones y escisiones, la función Fusiones y adquisiciones.
| Campo | Significado | Ejemplo | Disponibilidad |
|---|---|---|---|
| managementarray |
Las relaciones directas actuales de la empresa como lista simple. Llega con la función network sin coste adicional.Vacío cuando no se conocen relacionesnetwork · desde Pro · Beta |
– | casi siempre |
| management[].full_namestring | Nombre de la persona o empresa. |
"Max Felix Mustermann" |
como arriba |
| management[].relation_labelstring |
El tipo de relación: un cargo o una participación en personas, un vínculo entre empresas en empresas. Pueden añadirse valores nuevos.Valores: MANAGING_DIRECTOR administrador (Geschäftsführer), BOARD miembro del consejo de dirección (Vorstand), BOARD_CHAIR presidencia del consejo de dirección, PROCURA apoderado con Prokura (Prokurist), LIQUIDATOR liquidador, INSOLVENCY_ADMINISTRATOR administrador concursal, FULLY_LIABLE_PARTNER socio colectivo con responsabilidad personal, LIMITED_PARTNER socio comanditario (Kommanditist), PARTNER socio, OWNER titular, FULLY_LIABLE_FOR socio colectivo (Komplementär) de la empresa nombrada, LIMITED_PARTNER_OF socio comanditario de la empresa nombrada, ENTERPRISE_AGREEMENT_WITH contrato entre empresas (Unternehmensvertrag), MERGED_INTO fusión, MERGER_WITH fusión, ABSORBED fusión, SPLIT_INTO escisión, SPLIT_FROM escisión, SQUEEZED_OUT_BY exclusión de minoritarios (squeeze-out), REFERENCE referencia en la inscripción registral, REFERENCED_BY referencia en la inscripción registral |
"MANAGING_DIRECTOR" |
como arriba |
| management[].labelobject | Una etiqueta en de y en, la misma para todas las entradas. Qué relación existe lo lees en relation_label. | – | como arriba |
| management[].meta.start_datestring|null | Inicio, si se conoce: en cargos como YYYY-MM-DD, en transformaciones con hora.Vacío cuando no se conoce ninguna fecha |
"2015-07-28" |
como arriba |
| management[].meta.end_datenull | Fin de la relación. La lista muestra relaciones actuales, así que es null. |
null |
como arriba |
| management[].effective_end_datenull | Fin de la relación. La lista muestra relaciones actuales, así que es null. |
null |
como arriba |
| management[].end_reasonnull | Motivo del fin de la relación. La lista muestra relaciones actuales, así que es null. |
null |
como arriba |
| management[].meta.lineage_kindstring |
Solo en vínculos entre empresas: el tipo de operación.Valores: TRANSFORMATION_MERGER fusión, TRANSFORMATION_SPLIT escisión, ENTERPRISE_AGREEMENT contrato entre empresas, GROUP_ENTERPRISE_AGREEMENT contrato entre empresas dentro de un grupo, SQUEEZE_OUT exclusión de minoritarios (squeeze-out) |
– | rara vez |
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}
Red de una persona
El perfil de persona ofrece la misma función. Ahí la persona está en el centro, con los mismos campos que aquí.
Socios y participaciones
Participaciones, listas de socios y titulares reales en detalle.
Personas y representación
Administración, consejo de dirección y Prokura de una empresa.
fetch-organization
El endpoint con todos los parámetros y funciones.
fetch-person
El perfil de persona con cargos, participaciones y red.