네트워크
회사와 인물이 연결되는 방식.
network 기능(기업 네트워크)는 회사가 다른 회사, 인물과 어떻게 연결되어 있는지 보여 줘요: 대표이사나 Prokura(등기된 대리권) 같은 직위, 지분, 계열사를 통해서요.
연결은 Handelsregister(상업 등기부)와 Gesellschafterlisten(주주 명부)에서 와요. 회사에서 직접 연결된 상대까지, 그리고 거기서 한 단계 더, 두 단계 깊이까지 이어져요.
이 기능은 Pro 및 Max 플랜에 포함되며 아직 베타예요. 25 크레딧가 들지만, 네트워크에 연결이 하나 이상 있을 때만이에요. 다른 플랜에서는 API가 오류 없이 빼요.
구조
응답은 그래프예요. nodes에는 회사와 인물이, connections에는 그 사이의 연결이 있어요. 둘은 node_id로 이어져요.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'q=Hetzner Online GmbH' \ --data-urlencode 'feature=network'
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();
| 필드 | 의미 | 예시 | 제공 빈도 |
|---|---|---|---|
| networkobject|null |
회사 주변의 네트워크: nodes의 노드, connections의 연결.비어 있는 경우: 회사에 알려진 연결이 없음network · Pro부터 · 베타 |
– | 대부분 |
| network.depthinteger | 회사부터 센 네트워크의 단계 수. 회사 자신은 0단계예요. |
2 |
위와 같음 |
| network.truncatedboolean | 네트워크가 응답에 전부 들어 있지 않으면 true. |
false |
위와 같음 |
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "network": {5 "depth": 2,6 "nodes": [7 {8 "entity_id": "94eb910fef13f94585c48c263fa446d4",9 "type": "ORGANIZATION",10 "name": "Hetzner Online GmbH",11 "depth": 0,12 "is_root": true,13 "status": "ACTIVE",14 "registration_status": "ACTIVE",15 "cessation_date": null,16 "node_id": "94eb910fef13f94585c48c263fa446d4"17 },18 {19 "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",20 "type": "ORGANIZATION",21 "name": "ENSoXX GmbH",22 "depth": 1,23 "is_root": false,24 "status": "ACTIVE",25 "registration_status": "ACTIVE",26 "cessation_date": null,27 "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"28 },29 {30 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",31 "type": "PERSON",32 "name": "Jan Musterhuber",33 "depth": 1,34 "is_root": false,35 "status": null,36 "registration_status": null,37 "cessation_date": null,38 "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"39 },40 {41 "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",42 "type": "ORGANIZATION",43 "name": "Headtrip GmbH",44 "depth": 1,45 "is_root": false,46 "status": "INACTIVE",47 "registration_status": "TERMINATED",48 "cessation_date": "2023-08-17",49 "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"50 },51 {52 "entity_id": "0b3435f83ce8591300625100815d4583",53 "type": "ORGANIZATION",54 "name": "Hetzner Online AG",55 "depth": 1,56 "is_root": false,57 "status": "ACTIVE",58 "registration_status": "ACTIVE",59 "cessation_date": null,60 "node_id": "0b3435f83ce8591300625100815d4583"61 },62 {63 "entity_id": "08ed5f967956831ca6588930fd2693ed",64 "type": "PERSON",65 "name": "Max Felix Mustermann",66 "depth": 1,67 "is_root": false,68 "status": null,69 "registration_status": null,70 "cessation_date": null,71 "node_id": "08ed5f967956831ca6588930fd2693ed"72 },73 {74 "entity_id": "ea3a1670232611a992727ed067216d07",75 "type": "PERSON",76 "name": "Paul Musterwald",77 "depth": 1,78 "is_root": false,79 "status": null,80 "registration_status": null,81 "cessation_date": null,82 "node_id": "ea3a1670232611a992727ed067216d07"83 },84 {85 "entity_id": "e5bddadd46117c0d0b54f5c8f3334c50",86 "type": "PERSON",87 "name": "Moritz Musterhoff",88 "depth": 2,89 "is_root": false,90 "status": null,91 "registration_status": null,92 "cessation_date": null,93 "node_id": "e5bddadd46117c0d0b54f5c8f3334c50"94 },95 {96 "entity_id": "260286ab8baa3a8977fddd56b9361c6c",97 "type": "ORGANIZATION",98 "name": "DreamSoXX GmbH",99 "depth": 2,100 "is_root": false,101 "status": "ACTIVE",102 "registration_status": "ACTIVE",103 "cessation_date": null,104 "node_id": "260286ab8baa3a8977fddd56b9361c6c"105 },106 {107 "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",108 "type": "ORGANIZATION",109 "name": "ENSoXX Holding AG",110 "depth": 2,111 "is_root": false,112 "status": "ACTIVE",113 "registration_status": "ACTIVE",114 "cessation_date": null,115 "node_id": "58d67a0bb99b2bc5644cb8daba58e6a6"116 },117 {118 "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",119 "type": "ORGANIZATION",120 "name": "ENSoXX Invest GmbH",121 "depth": 2,122 "is_root": false,123 "status": "ACTIVE",124 "registration_status": "ACTIVE",125 "cessation_date": null,126 "node_id": "0e8b1b4fc27a3ecc07d397750505e7b5"127 },128 {129 "entity_id": "bc1c1e106ade810eb960c779d4c752a8",130 "type": "ORGANIZATION",131 "name": "ENSoXX hilft e.V.",132 "depth": 2,133 "is_root": false,134 "status": "ACTIVE",135 "registration_status": "ACTIVE",136 "cessation_date": null,137 "node_id": "bc1c1e106ade810eb960c779d4c752a8"138 },139 {140 "entity_id": "1184637be046741e9f0bb5d401feeb2b",141 "type": "PERSON",142 "name": "Tobias Musterhain",143 "depth": 2,144 "is_root": false,145 "status": null,146 "registration_status": null,147 "cessation_date": null,148 "node_id": "1184637be046741e9f0bb5d401feeb2b"149 },150 {151 "entity_id": "2ab71b59057969183dd811adf9f32ebd",152 "type": "ORGANIZATION",153 "name": "HT clean energy GmbH",154 "depth": 2,155 "is_root": false,156 "status": "ACTIVE",157 "registration_status": "ACTIVE",158 "cessation_date": null,159 "node_id": "2ab71b59057969183dd811adf9f32ebd"160 },161 {162 "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",163 "type": "ORGANIZATION",164 "name": "Lighthouse GmbH",165 "depth": 2,166 "is_root": false,167 "status": "ACTIVE",168 "registration_status": "ACTIVE",169 "cessation_date": null,170 "node_id": "7582db1f94e1538ba8f531f6a95a7f1b"171 },172 {173 "entity_id": "4cd425f9ad57d6119f704ba53131b480",174 "type": "ORGANIZATION",175 "name": "Modellsportclub Gunzenhausen e.V.",176 "depth": 2,177 "is_root": false,178 "status": "ACTIVE",179 "registration_status": "ACTIVE",180 "cessation_date": null,181 "node_id": "4cd425f9ad57d6119f704ba53131b480"182 },183 {184 "entity_id": "232d2ed634eef59eb21836cc47cb5645",185 "type": "ORGANIZATION",186 "name": "Sonnenkraft Merkendorf GmbH & Co. KG",187 "depth": 2,188 "is_root": false,189 "status": "ACTIVE",190 "registration_status": "ACTIVE",191 "cessation_date": null,192 "node_id": "232d2ed634eef59eb21836cc47cb5645"193 },194 {195 "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",196 "type": "ORGANIZATION",197 "name": "TRAIDY UG (haftungsbeschränkt)",198 "depth": 2,199 "is_root": false,200 "status": "ACTIVE",201 "registration_status": "ACTIVE",202 "cessation_date": null,203 "node_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10"204 },205 {206 "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",207 "type": "ORGANIZATION",208 "name": "possum Projekt 1 GmbH",209 "depth": 2,210 "is_root": false,211 "status": "ACTIVE",212 "registration_status": "ACTIVE",213 "cessation_date": null,214 "node_id": "64922d416b4dd7006f3c2c62efaabd5d"215 },216 {217 "entity_id": "997f1b8314b8b56573208ae2334abb1d",218 "type": "ORGANIZATION",219 "name": "possum Projekt 1 GmbH",220 "depth": 2,221 "is_root": false,222 "status": "ACTIVE",223 "registration_status": "ACTIVE",224 "cessation_date": null,225 "node_id": "997f1b8314b8b56573208ae2334abb1d"226 }227 ],228 "connections": [229 {230 "source": {231 "entity_id": "08ed5f967956831ca6588930fd2693ed",232 "type": "PERSON",233 "name": "Max Felix Mustermann",234 "node_id": "08ed5f967956831ca6588930fd2693ed"235 },236 "target": {237 "entity_id": "94eb910fef13f94585c48c263fa446d4",238 "type": "ORGANIZATION",239 "name": "Hetzner Online GmbH",240 "node_id": "94eb910fef13f94585c48c263fa446d4"241 },242 "connection_type": "ROLE",243 "label": "BOARD",244 "role": {245 "en": {246 "long": "Board Member",247 "short": "Board"248 },249 "de": {250 "long": "Vorstandsmitglied",251 "short": "Vorstand"252 }253 },254 "start_date": "2002-10-15",255 "end_date": "2015-07-28",256 "is_current": false,257 "depth": 1,258 "effective_end_date": "2015-07-28",259 "end_reason": "ROLE_ENDED"260 },261 {262 "source": {263 "entity_id": "08ed5f967956831ca6588930fd2693ed",264 "type": "PERSON",265 "name": "Max Felix Mustermann",266 "node_id": "08ed5f967956831ca6588930fd2693ed"267 },268 "target": {269 "entity_id": "94eb910fef13f94585c48c263fa446d4",270 "type": "ORGANIZATION",271 "name": "Hetzner Online GmbH",272 "node_id": "94eb910fef13f94585c48c263fa446d4"273 },274 "connection_type": "ROLE",275 "label": "MANAGING_DIRECTOR",276 "role": {277 "en": {278 "long": "Managing Director",279 "short": "MD"280 },281 "de": {282 "long": "Geschäftsführer",283 "short": "GF"284 }285 },286 "start_date": "2015-07-28",287 "end_date": null,288 "is_current": true,289 "depth": 1,290 "effective_end_date": null,291 "end_reason": null292 },293 {294 "source": {295 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",296 "type": "PERSON",297 "name": "Jan Musterhuber",298 "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"299 },300 "target": {301 "entity_id": "94eb910fef13f94585c48c263fa446d4",302 "type": "ORGANIZATION",303 "name": "Hetzner Online GmbH",304 "node_id": "94eb910fef13f94585c48c263fa446d4"305 },306 "connection_type": "ROLE",307 "label": "PROCURA",308 "role": {309 "en": {310 "long": "Procura",311 "short": "Procura"312 },313 "de": {314 "long": "Prokura",315 "short": "Prokura"316 }317 },318 "start_date": "2015-07-28",319 "end_date": "2019-01-04",320 "is_current": false,321 "depth": 1,322 "effective_end_date": "2019-01-04",323 "end_reason": "ROLE_ENDED"324 },325 {326 "source": {327 "entity_id": "ea3a1670232611a992727ed067216d07",328 "type": "PERSON",329 "name": "Paul Musterwald",330 "node_id": "ea3a1670232611a992727ed067216d07"331 },332 "target": {333 "entity_id": "94eb910fef13f94585c48c263fa446d4",334 "type": "ORGANIZATION",335 "name": "Hetzner Online GmbH",336 "node_id": "94eb910fef13f94585c48c263fa446d4"337 },338 "connection_type": "ROLE",339 "label": "PROCURA",340 "role": {341 "en": {342 "long": "Procura",343 "short": "Procura"344 },345 "de": {346 "long": "Prokura",347 "short": "Prokura"348 }349 },350 "start_date": "2015-07-28",351 "end_date": "2019-01-04",352 "is_current": false,353 "depth": 1,354 "effective_end_date": "2019-01-04",355 "end_reason": "ROLE_ENDED"356 },357 {358 "source": {359 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",360 "type": "PERSON",361 "name": "Jan Musterhuber",362 "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"363 },364 "target": {365 "entity_id": "94eb910fef13f94585c48c263fa446d4",366 "type": "ORGANIZATION",367 "name": "Hetzner Online GmbH",368 "node_id": "94eb910fef13f94585c48c263fa446d4"369 },370 "connection_type": "ROLE",371 "label": "MANAGING_DIRECTOR",372 "role": {373 "en": {374 "long": "Managing Director",375 "short": "MD"376 },377 "de": {378 "long": "Geschäftsführer",379 "short": "GF"380 }381 },382 "start_date": "2019-01-04",383 "end_date": null,384 "is_current": true,385 "depth": 1,386 "effective_end_date": null,387 "end_reason": null388 },389 {390 "source": {391 "entity_id": "ea3a1670232611a992727ed067216d07",392 "type": "PERSON",393 "name": "Paul Musterwald",394 "node_id": "ea3a1670232611a992727ed067216d07"395 },396 "target": {397 "entity_id": "94eb910fef13f94585c48c263fa446d4",398 "type": "ORGANIZATION",399 "name": "Hetzner Online GmbH",400 "node_id": "94eb910fef13f94585c48c263fa446d4"401 },402 "connection_type": "ROLE",403 "label": "MANAGING_DIRECTOR",404 "role": {405 "en": {406 "long": "Managing Director",407 "short": "MD"408 },409 "de": {410 "long": "Geschäftsführer",411 "short": "GF"412 }413 },414 "start_date": "2019-01-04",415 "end_date": null,416 "is_current": true,417 "depth": 1,418 "effective_end_date": null,419 "end_reason": null420 },421 {422 "source": {423 "entity_id": "08ed5f967956831ca6588930fd2693ed",424 "type": "PERSON",425 "name": "Max Felix Mustermann",426 "node_id": "08ed5f967956831ca6588930fd2693ed"427 },428 "target": {429 "entity_id": "94eb910fef13f94585c48c263fa446d4",430 "type": "ORGANIZATION",431 "name": "Hetzner Online GmbH",432 "node_id": "94eb910fef13f94585c48c263fa446d4"433 },434 "connection_type": "OWNERSHIP",435 "label": "SHAREHOLDER",436 "role": {437 "en": {438 "long": "Shareholder",439 "short": "Shareholder"440 },441 "de": {442 "long": "Gesellschafter",443 "short": "Gesellschafter"444 }445 },446 "start_date": null,447 "end_date": null,448 "is_current": true,449 "depth": 1,450 "ownership": {451 "percentage": 5.5,452 "amount": {453 "value": 2750,454 "currency": "EUR"455 },456 "as_of": "2015-08-21",457 "source": "shareholder_list"458 },459 "effective_end_date": null,460 "end_reason": null461 },462 {463 "source": {464 "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",465 "type": "ORGANIZATION",466 "name": "ENSoXX GmbH",467 "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"468 },469 "target": {470 "entity_id": "94eb910fef13f94585c48c263fa446d4",471 "type": "ORGANIZATION",472 "name": "Hetzner Online GmbH",473 "node_id": "94eb910fef13f94585c48c263fa446d4"474 },475 "connection_type": "OWNERSHIP",476 "label": "SHAREHOLDER",477 "role": {478 "en": {479 "long": "Shareholder",480 "short": "Shareholder"481 },482 "de": {483 "long": "Gesellschafter",484 "short": "Gesellschafter"485 }486 },487 "start_date": null,488 "end_date": null,489 "is_current": true,490 "depth": 1,491 "ownership": {492 "percentage": 94.5,493 "amount": {494 "value": 47250,495 "currency": "EUR"496 },497 "as_of": "2015-08-21",498 "source": "shareholder_list"499 },500 "effective_end_date": null,501 "end_reason": null502 },503 {504 "source": {505 "entity_id": "08ed5f967956831ca6588930fd2693ed",506 "type": "PERSON",507 "name": "Max Felix Mustermann",508 "node_id": "08ed5f967956831ca6588930fd2693ed"509 },510 "target": {511 "entity_id": "0b3435f83ce8591300625100815d4583",512 "type": "ORGANIZATION",513 "name": "Hetzner Online AG",514 "node_id": "0b3435f83ce8591300625100815d4583"515 },516 "connection_type": "ROLE",517 "label": "BOARD",518 "role": {519 "en": {520 "long": "Board Member",521 "short": "Board"522 },523 "de": {524 "long": "Vorstandsmitglied",525 "short": "Vorstand"526 }527 },528 "start_date": "2002-10-15",529 "end_date": "2015-07-28",530 "is_current": false,531 "depth": 2,532 "effective_end_date": "2015-07-28",533 "end_reason": "ROLE_ENDED"534 },535 {536 "source": {537 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",538 "type": "PERSON",539 "name": "Jan Musterhuber",540 "node_id": "dd7e94b41f78de4195cc70c6b0f732f3"541 },542 "target": {543 "entity_id": "0b3435f83ce8591300625100815d4583",544 "type": "ORGANIZATION",545 "name": "Hetzner Online AG",546 "node_id": "0b3435f83ce8591300625100815d4583"547 },548 "connection_type": "ROLE",549 "label": "PROCURA",550 "role": {551 "en": {552 "long": "Procura",553 "short": "Procura"554 },555 "de": {556 "long": "Prokura",557 "short": "Prokura"558 }559 },560 "start_date": "2009-01-02",561 "end_date": null,562 "is_current": true,563 "depth": 2,564 "effective_end_date": null,565 "end_reason": null566 },567 {568 "source": {569 "entity_id": "ea3a1670232611a992727ed067216d07",570 "type": "PERSON",571 "name": "Paul Musterwald",572 "node_id": "ea3a1670232611a992727ed067216d07"573 },574 "target": {575 "entity_id": "0b3435f83ce8591300625100815d4583",576 "type": "ORGANIZATION",577 "name": "Hetzner Online AG",578 "node_id": "0b3435f83ce8591300625100815d4583"579 },580 "connection_type": "ROLE",581 "label": "PROCURA",582 "role": {583 "en": {584 "long": "Procura",585 "short": "Procura"586 },587 "de": {588 "long": "Prokura",589 "short": "Prokura"590 }591 },592 "start_date": "2009-01-02",593 "end_date": null,594 "is_current": true,595 "depth": 2,596 "effective_end_date": null,597 "end_reason": null598 },599 {600 "source": {601 "entity_id": "08ed5f967956831ca6588930fd2693ed",602 "type": "PERSON",603 "name": "Max Felix Mustermann",604 "node_id": "08ed5f967956831ca6588930fd2693ed"605 },606 "target": {607 "entity_id": "0b3435f83ce8591300625100815d4583",608 "type": "ORGANIZATION",609 "name": "Hetzner Online AG",610 "node_id": "0b3435f83ce8591300625100815d4583"611 },612 "connection_type": "ROLE",613 "label": "MANAGING_DIRECTOR",614 "role": {615 "en": {616 "long": "Managing Director",617 "short": "MD"618 },619 "de": {620 "long": "Geschäftsführer",621 "short": "GF"622 }623 },624 "start_date": "2015-07-28",625 "end_date": null,626 "is_current": true,627 "depth": 2,628 "effective_end_date": null,629 "end_reason": null630 },631 {632 "source": {633 "entity_id": "08ed5f967956831ca6588930fd2693ed",634 "type": "PERSON",635 "name": "Max Felix Mustermann",636 "node_id": "08ed5f967956831ca6588930fd2693ed"637 },638 "target": {639 "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",640 "type": "ORGANIZATION",641 "name": "ENSoXX GmbH",642 "node_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf"643 },644 "connection_type": "ROLE",645 "label": "MANAGING_DIRECTOR",646 "role": {647 "en": {648 "long": "Managing Director",649 "short": "MD"650 },651 "de": {652 "long": "Geschäftsführer",653 "short": "GF"654 }655 },656 "start_date": "2015-08-14",657 "end_date": null,658 "is_current": true,659 "depth": 2,660 "effective_end_date": null,661 "end_reason": null662 },663 {664 "source": {665 "entity_id": "08ed5f967956831ca6588930fd2693ed",666 "type": "PERSON",667 "name": "Max Felix Mustermann",668 "node_id": "08ed5f967956831ca6588930fd2693ed"669 },670 "target": {671 "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",672 "type": "ORGANIZATION",673 "name": "ENSoXX Holding AG",674 "node_id": "58d67a0bb99b2bc5644cb8daba58e6a6"675 },676 "connection_type": "ROLE",677 "label": "BOARD",678 "role": {679 "en": {680 "long": "Board Member",681 "short": "Board"682 },683 "de": {684 "long": "Vorstandsmitglied",685 "short": "Vorstand"686 }687 },688 "start_date": "2016-02-03",689 "end_date": null,690 "is_current": true,691 "depth": 2,692 "effective_end_date": null,693 "end_reason": null694 },695 {696 "source": {697 "entity_id": "1184637be046741e9f0bb5d401feeb2b",698 "type": "PERSON",699 "name": "Tobias Musterhain",700 "node_id": "1184637be046741e9f0bb5d401feeb2b"701 },702 "target": {703 "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",704 "type": "ORGANIZATION",705 "name": "Headtrip GmbH",706 "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"707 },708 "connection_type": "ROLE",709 "label": "MANAGING_DIRECTOR",710 "role": {711 "en": {712 "long": "Managing Director",713 "short": "MD"714 },715 "de": {716 "long": "Geschäftsführer",717 "short": "GF"718 }719 },720 "start_date": "2016-10-28",721 "end_date": null,722 "is_current": false,723 "depth": 2,724 "effective_end_date": "2023-08-17",725 "end_reason": "ORGANIZATION_TERMINATED"726 },727 {728 "source": {729 "entity_id": "e5bddadd46117c0d0b54f5c8f3334c50",730 "type": "PERSON",731 "name": "Moritz Musterhoff",732 "node_id": "e5bddadd46117c0d0b54f5c8f3334c50"733 },734 "target": {735 "entity_id": "dd4d2d6854b2dbd1ffce74e669f3852e",736 "type": "ORGANIZATION",737 "name": "Headtrip GmbH",738 "node_id": "dd4d2d6854b2dbd1ffce74e669f3852e"739 },740 "connection_type": "ROLE",741 "label": "MANAGING_DIRECTOR",742 "role": {743 "en": {744 "long": "Managing Director",745 "short": "MD"746 },747 "de": {748 "long": "Geschäftsführer",749 "short": "GF"750 }751 },752 "start_date": "2016-10-28",753 "end_date": null,754 "is_current": false,755 "depth": 2,756 "effective_end_date": "2023-08-17",757 "end_reason": "ORGANIZATION_TERMINATED"758 },759 {760 "source": {761 "entity_id": "08ed5f967956831ca6588930fd2693ed",762 "type": "PERSON",763 "name": "Max Felix Mustermann",764 "node_id": "08ed5f967956831ca6588930fd2693ed"765 },766 "target": {767 "entity_id": "bc1c1e106ade810eb960c779d4c752a8",768 "type": "ORGANIZATION",769 "name": "ENSoXX hilft e.V.",770 "node_id": "bc1c1e106ade810eb960c779d4c752a8"771 },772 "connection_type": "ROLE",773 "label": "BOARD",774 "role": {775 "en": {776 "long": "Board Member",777 "short": "Board"778 },779 "de": {780 "long": "Vorstandsmitglied",781 "short": "Vorstand"782 }783 },784 "start_date": "2017-02-24",785 "end_date": null,786 "is_current": true,787 "depth": 2,788 "effective_end_date": null,789 "end_reason": null790 },791 {792 "source": {793 "entity_id": "08ed5f967956831ca6588930fd2693ed",794 "type": "PERSON",795 "name": "Max Felix Mustermann",796 "node_id": "08ed5f967956831ca6588930fd2693ed"797 },798 "target": {799 "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",800 "type": "ORGANIZATION",801 "name": "TRAIDY UG (haftungsbeschränkt)",802 "node_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10"803 },804 "connection_type": "ROLE",805 "label": "MANAGING_DIRECTOR",806 "role": {807 "en": {808 "long": "Managing Director",809 "short": "MD"810 },811 "de": {812 "long": "Geschäftsführer",813 "short": "GF"814 }815 },816 "start_date": "2022-03-14",817 "end_date": null,818 "is_current": true,819 "depth": 2,820 "effective_end_date": null,821 "end_reason": null822 },823 {824 "source": {825 "entity_id": "08ed5f967956831ca6588930fd2693ed",826 "type": "PERSON",827 "name": "Max Felix Mustermann",828 "node_id": "08ed5f967956831ca6588930fd2693ed"829 },830 "target": {831 "entity_id": "4cd425f9ad57d6119f704ba53131b480",832 "type": "ORGANIZATION",833 "name": "Modellsportclub Gunzenhausen e.V.",834 "node_id": "4cd425f9ad57d6119f704ba53131b480"835 },836 "connection_type": "ROLE",837 "label": "BOARD",838 "role": {839 "en": {840 "long": "Board Member",841 "short": "Board"842 },843 "de": {844 "long": "Vorstandsmitglied",845 "short": "Vorstand"846 }847 },848 "start_date": "2023-06-06",849 "end_date": "2026-08-12",850 "is_current": false,851 "depth": 2,852 "effective_end_date": "2026-08-12",853 "end_reason": "ROLE_ENDED"854 },855 {856 "source": {857 "entity_id": "08ed5f967956831ca6588930fd2693ed",858 "type": "PERSON",859 "name": "Max Felix Mustermann",860 "node_id": "08ed5f967956831ca6588930fd2693ed"861 },862 "target": {863 "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",864 "type": "ORGANIZATION",865 "name": "ENSoXX Invest GmbH",866 "node_id": "0e8b1b4fc27a3ecc07d397750505e7b5"867 },868 "connection_type": "ROLE",869 "label": "MANAGING_DIRECTOR",870 "role": {871 "en": {872 "long": "Managing Director",873 "short": "MD"874 },875 "de": {876 "long": "Geschäftsführer",877 "short": "GF"878 }879 },880 "start_date": "2023-12-13",881 "end_date": null,882 "is_current": true,883 "depth": 2,884 "effective_end_date": null,885 "end_reason": null886 },887 {888 "source": {889 "entity_id": "08ed5f967956831ca6588930fd2693ed",890 "type": "PERSON",891 "name": "Max Felix Mustermann",892 "node_id": "08ed5f967956831ca6588930fd2693ed"893 },894 "target": {895 "entity_id": "2ab71b59057969183dd811adf9f32ebd",896 "type": "ORGANIZATION",897 "name": "HT clean energy GmbH",898 "node_id": "2ab71b59057969183dd811adf9f32ebd"899 },900 "connection_type": "ROLE",901 "label": "MANAGING_DIRECTOR",902 "role": {903 "en": {904 "long": "Managing Director",905 "short": "MD"906 },907 "de": {908 "long": "Geschäftsführer",909 "short": "GF"910 }911 },912 "start_date": "2024-08-20",913 "end_date": null,914 "is_current": true,915 "depth": 2,916 "effective_end_date": null,917 "end_reason": null918 },919 {920 "source": {921 "entity_id": "08ed5f967956831ca6588930fd2693ed",922 "type": "PERSON",923 "name": "Max Felix Mustermann",924 "node_id": "08ed5f967956831ca6588930fd2693ed"925 },926 "target": {927 "entity_id": "260286ab8baa3a8977fddd56b9361c6c",928 "type": "ORGANIZATION",929 "name": "DreamSoXX GmbH",930 "node_id": "260286ab8baa3a8977fddd56b9361c6c"931 },932 "connection_type": "ROLE",933 "label": "MANAGING_DIRECTOR",934 "role": {935 "en": {936 "long": "Managing Director",937 "short": "MD"938 },939 "de": {940 "long": "Geschäftsführer",941 "short": "GF"942 }943 },944 "start_date": "2025-01-13",945 "end_date": null,946 "is_current": true,947 "depth": 2,948 "effective_end_date": null,949 "end_reason": null950 },951 {952 "source": {953 "entity_id": "08ed5f967956831ca6588930fd2693ed",954 "type": "PERSON",955 "name": "Max Felix Mustermann",956 "node_id": "08ed5f967956831ca6588930fd2693ed"957 },958 "target": {959 "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",960 "type": "ORGANIZATION",961 "name": "Lighthouse GmbH",962 "node_id": "7582db1f94e1538ba8f531f6a95a7f1b"963 },964 "connection_type": "ROLE",965 "label": "PROCURA",966 "role": {967 "en": {968 "long": "Procura",969 "short": "Procura"970 },971 "de": {972 "long": "Prokura",973 "short": "Prokura"974 }975 },976 "start_date": "2025-03-25",977 "end_date": null,978 "is_current": true,979 "depth": 2,980 "effective_end_date": null,981 "end_reason": null982 },983 {984 "source": {985 "entity_id": "08ed5f967956831ca6588930fd2693ed",986 "type": "PERSON",987 "name": "Max Felix Mustermann",988 "node_id": "08ed5f967956831ca6588930fd2693ed"989 },990 "target": {991 "entity_id": "232d2ed634eef59eb21836cc47cb5645",992 "type": "ORGANIZATION",993 "name": "Sonnenkraft Merkendorf GmbH & Co. KG",994 "node_id": "232d2ed634eef59eb21836cc47cb5645"995 },996 "connection_type": "OWNERSHIP",997 "label": "LIMITED_PARTNER",998 "role": {999 "en": {1000 "long": "Limited Partner",1001 "short": "LP"1002 },1003 "de": {1004 "long": "Kommanditist",1005 "short": "Kom"1006 }1007 },1008 "start_date": "2026-02-18",1009 "end_date": null,1010 "is_current": true,1011 "depth": 2,1012 "ownership": null,1013 "effective_end_date": null,1014 "end_reason": null1015 },1016 {1017 "source": {1018 "entity_id": "08ed5f967956831ca6588930fd2693ed",1019 "type": "PERSON",1020 "name": "Max Felix Mustermann",1021 "node_id": "08ed5f967956831ca6588930fd2693ed"1022 },1023 "target": {1024 "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",1025 "type": "ORGANIZATION",1026 "name": "possum Projekt 1 GmbH",1027 "node_id": "64922d416b4dd7006f3c2c62efaabd5d"1028 },1029 "connection_type": "ROLE",1030 "label": "PROCURA",1031 "role": {1032 "en": {1033 "long": "Procura",1034 "short": "Procura"1035 },1036 "de": {1037 "long": "Prokura",1038 "short": "Prokura"1039 }1040 },1041 "start_date": "2026-09-04",1042 "end_date": null,1043 "is_current": true,1044 "depth": 2,1045 "effective_end_date": null,1046 "end_reason": null1047 },1048 {1049 "source": {1050 "entity_id": "08ed5f967956831ca6588930fd2693ed",1051 "type": "PERSON",1052 "name": "Max Felix Mustermann",1053 "node_id": "08ed5f967956831ca6588930fd2693ed"1054 },1055 "target": {1056 "entity_id": "997f1b8314b8b56573208ae2334abb1d",1057 "type": "ORGANIZATION",1058 "name": "possum Projekt 1 GmbH",1059 "node_id": "997f1b8314b8b56573208ae2334abb1d"1060 },1061 "connection_type": "ROLE",1062 "label": "PROCURA",1063 "role": {1064 "en": {1065 "long": "Procura",1066 "short": "Procura"1067 },1068 "de": {1069 "long": "Prokura",1070 "short": "Prokura"1071 }1072 },1073 "start_date": "2026-09-04",1074 "end_date": null,1075 "is_current": true,1076 "depth": 2,1077 "effective_end_date": null,1078 "end_reason": null1079 }1080 ],1081 "truncated": false1082 }1083}
연결된 회사와 인물
각 노드는 회사나 인물이에요. 요청한 회사는 is_root: true와 depth: 0으로 들어 있고, 직접 연결된 상대는 depth: 1, 그 상대의 연결은 depth: 2예요.
| 필드 | 의미 | 예시 | 제공 빈도 |
|---|---|---|---|
| network.nodesarray |
요청한 회사를 포함해 네트워크의 모든 회사와 인물.network · Pro부터 · 베타 |
– | 대부분 |
| network.nodes[].node_idstring | source와 target이 가리키는 노드 ID. 매칭된 회사와 인물은 entity_id와 같아요. |
"94eb910fef13f94585c48c263fa446d4" |
위와 같음 |
| network.nodes[].entity_idstring|null | 회사나 인물의 ID, 회사 프로필이나 인물 프로필용.비어 있는 경우: 주주가 주주 명부에서만 알려져 있고 확실하게 매칭할 수 없었음 |
"94eb910fef13f94585c48c263fa446d4" |
위와 같음 |
| network.nodes[].typestring |
노드의 종류.값: ORGANIZATION 회사, PERSON 인물 |
"ORGANIZATION" |
위와 같음 |
| network.nodes[].namestring | 회사나 인물의 이름. |
"Hetzner Online GmbH" |
위와 같음 |
| network.nodes[].depthinteger | 요청한 회사와의 거리: 0은 회사 자신, 1은 직접 연결, 2는 연결의 연결. |
0 |
위와 같음 |
| network.nodes[].is_rootboolean | 요청한 회사에만 true. |
true |
위와 같음 |
| network.nodes[].statusstring|null |
조직에만: 등기부상의 현재 상태.비어 있는 경우: 노드가 인물임값: ACTIVE 활성, INACTIVE 더 이상 활성 상태가 아님, 예: 말소 또는 합병 |
"ACTIVE" |
위와 같음 |
| network.nodes[].registration_statusstring|null |
회사의 등기 상태. 다른 값도 있을 수 있으니, 알 수 없는 값은 “비활성”으로 다루세요.비어 있는 경우: 노드가 인물임값: ACTIVE 활성, TERMINATED 등기부에서 말소 |
"ACTIVE" |
위와 같음 |
| network.nodes[].cessation_datestring|null | 더 이상 활성 상태가 아닌 회사에만: 회사가 없어진 날짜, YYYY-MM-DD 형식.비어 있는 경우: 회사가 활성 상태이거나 노드가 인물임 |
null |
드묾 |
| network.nodes[].registration_referencestring|null | entity_id가 없는 노드에만: 주주 명부에 적힌 회사의 등기. | – | 위와 같음 |
| network.nodes[].country_codestring|null | entity_id가 없는 노드에만: ISO 세 글자 코드로 된 회사의 국가. | – | 위와 같음 |
| network.nodes[].birth_datestring|null | entity_id가 없는 노드에만: 주주 명부에서 가져온 인물의 생년월일. | – | 위와 같음 |
노드의 entity_id로 회사 프로필이나 인물 프로필을 가져와 거기서부터 네트워크를 따라갈 수 있어요.
연결 읽기
연결은 source에서 target으로 이어져요. source는 직위, 지분, 그룹 관계를 가진 인물이나 회사이고, target은 그것이 존재하는 회사예요.
connection_type은 연결의 종류를, label은 정확한 이름을 알려 줘요. 표시용 레이블은 role.de와 role.en에 있어요.
| connection_type | 의미 | label의 대표적인 값 |
|---|---|---|
| ROLE | 회사에서의 직위 | MANAGING_DIRECTOR, BOARD, PROCURA |
| OWNERSHIP | 회사에 대한 지분 | SHAREHOLDER, LIMITED_PARTNER, FULLY_LIABLE_PARTNER |
| GROUP | 계열사 | AFFILIATED_COMPANY |
| 필드 | 의미 | 예시 | 제공 빈도 |
|---|---|---|---|
| network.connectionsarray |
노드 사이의 모든 연결, 현재와 종료된 것.network · Pro부터 · 베타 |
– | 대부분 |
| network.connections[].sourceobject | 연결이 시작되는 곳: entity_id, node_id, type, name. | – | 위와 같음 |
| network.connections[].targetobject | 직위, 지분, 관계가 존재하는 회사, 같은 필드. | – | 위와 같음 |
| network.connections[].connection_typestring |
연결의 종류.값: ROLE 직위, OWNERSHIP 지분, GROUP 계열사 |
"ROLE" |
위와 같음 |
| network.connections[].labelstring |
연결의 정확한 이름. 새 값이 추가될 수 있어요.값: MANAGING_DIRECTOR 대표이사(Geschäftsführer), BOARD 이사회 구성원(Vorstand), BOARD_CHAIR 이사회 의장, DIRECTOR 집행 이사, 예: SE, PROCURA Prokura 보유자(Prokurist), LIQUIDATOR 청산인, INSOLVENCY_ADMINISTRATOR 파산 관재인, REPRESENTATIVE 상임 대리인, TREASURER 사단의 회계 담당, SECRETARY 사단의 서기, OTHER 기타 역할, SHAREHOLDER 주주 명부상의 주주, LIMITED_PARTNER 유한책임사원(Kommanditist), FULLY_LIABLE_PARTNER 개인적으로 무한책임을 지는 무한책임사원, PARTNER 파트너, OWNER 소유자, AFFILIATED_COMPANY 계열사 |
"BOARD" |
위와 같음 |
| network.connections[].roleobject | 표시용 레이블: de와 en, 각각 long과 short. | – | 위와 같음 |
| network.connections[].start_datestring|null | 등기부상의 시작, YYYY-MM-DD 형식.비어 있는 경우: 등기부에 날짜가 없음 |
"2002-10-15" |
위와 같음 |
| network.connections[].end_datestring|null | 등기부상의 종료.비어 있는 경우: 연결이 아직 있거나 날짜를 알 수 없음 |
"2015-07-28" |
위와 같음 |
| network.connections[].effective_end_datestring|null | 연결이 실제로 끝난 날짜: end_date, 또는 등기부에 연결의 종료가 없으면 회사가 없어진 날짜.비어 있는 경우: 연결이 아직 있거나 날짜를 알 수 없음 |
"2015-07-28" |
위와 같음 |
| network.connections[].end_reasonstring|null |
연결이 더 이상 없는 이유. 새 값이 추가될 수 있어요.비어 있는 경우: 연결이 아직 있음값: ROLE_ENDED 연결이 종료됨, ORGANIZATION_TERMINATED 회사가 더 이상 존재하지 않음 |
"ROLE_ENDED" |
위와 같음 |
| network.connections[].is_currentboolean | 연결이 지금도 있으면 true. |
false |
위와 같음 |
| network.connections[].depthinteger | 연결의 단계: 요청한 회사가 source나 target이면 1, 한 단계 더 나간 연결은 2. |
1 |
위와 같음 |
종료된 연결도 포함돼요. is_current는 연결이 지금도 있는지 보여 주고, start_date와 end_date는 알려진 경우 등기부의 날짜를 알려 줘요.
요청한 회사로 이어지는 OWNERSHIP 유형의 연결 중 많은 경우에 ownership도 있어요. 지분에 대해 알려진 내용이 담겨요: 주주 명부에서는 지분율과 액면가, 등기부에서는 예를 들어 유한책임사원의 책임액.
| 필드 | 의미 | 예시 | 제공 빈도 |
|---|---|---|---|
| network.connections[].ownershipobject|null |
요청한 회사로 이어지는 OWNERSHIP 연결에만, 그것도 전부는 아니에요: 지분에 대한 세부 정보. 그 밖의 경우 필드가 없어요.비어 있는 경우: 지분에 대해 알려진 것이 없음network · Pro부터 · 베타 |
– | 드묾 |
| network.connections[].ownership.percentagenumber|null | % 단위의 지분: 100은 100%예요.비어 있는 경우: 지분이 등기부에서 옴 | – | 위와 같음 |
| network.connections[].ownership.amountobject|null | value와 currency가 담긴 금액: 지분의 액면가 또는 유한책임사원의 책임액.비어 있는 경우: 알려진 금액이 없음 | – | 위와 같음 |
| network.connections[].ownership.as_ofstring|null | 지분의 출처인 주주 명부의 날짜.비어 있는 경우: 지분이 등기부에서 옴 | – | 위와 같음 |
| network.connections[].ownership.sourcestring |
지분의 출처.값: shareholder_list 주주 명부(Gesellschafterliste), commercial_register 상업 등기부(Handelsregister) |
– | 위와 같음 |
지분은 주주 명부에서 자동으로 추출해 회사, 인물과 연결해요. 이를 위해 최신 기술을 쓰고 품질에 많은 투자를 하지만, 개별 오류가 있을 수 있어요.
직접 관계
network를 쓰면 응답 최상위에 목록 management도 추가 비용 없이 받아요. 회사의 현재 직접 관계를 간단히 요약해요: 직위에 있는 인물과, 합병이나 기업 계약 등으로 연결된 회사.
항목에는 entity_id가 없어요. 분석과 후속 요청에는 network의 연결을, 합병과 분할의 세부 사항에는 인수합병 기능을 쓰세요.
| 필드 | 의미 | 예시 | 제공 빈도 |
|---|---|---|---|
| managementarray |
단순 목록으로 된 회사의 현재 직접 관계. network 기능과 함께 추가 비용 없이 와요.비어 있는 경우: 알려진 관계가 없음network · Pro부터 · 베타 |
– | 대부분 |
| management[].full_namestring | 인물이나 회사의 이름. |
"Max Felix Mustermann" |
위와 같음 |
| management[].relation_labelstring |
관계의 종류: 인물은 직위나 지분, 회사는 회사 간 관계. 새 값이 추가될 수 있어요.값: MANAGING_DIRECTOR 대표이사(Geschäftsführer), BOARD 이사회 구성원(Vorstand), BOARD_CHAIR 이사회 의장, PROCURA Prokura 보유자(Prokurist), LIQUIDATOR 청산인, INSOLVENCY_ADMINISTRATOR 파산 관재인, FULLY_LIABLE_PARTNER 개인적으로 무한책임을 지는 무한책임사원, LIMITED_PARTNER 유한책임사원(Kommanditist), PARTNER 파트너, OWNER 소유자, FULLY_LIABLE_FOR 기재된 회사의 무한책임사원(Komplementär), LIMITED_PARTNER_OF 기재된 회사의 유한책임사원, ENTERPRISE_AGREEMENT_WITH 기업 계약(Unternehmensvertrag), MERGED_INTO 합병, MERGER_WITH 합병, ABSORBED 합병, SPLIT_INTO 분할, SPLIT_FROM 분할, SQUEEZED_OUT_BY 소수 주주 축출(squeeze-out), REFERENCE 등기 내용의 참조, REFERENCED_BY 등기 내용의 참조 |
"MANAGING_DIRECTOR" |
위와 같음 |
| management[].labelobject | de와 en 레이블, 모든 항목에서 같아요. 어떤 관계인지는 relation_label에서 읽으세요. | – | 위와 같음 |
| management[].meta.start_datestring|null | 알려진 경우 시작: 직위는 YYYY-MM-DD, 조직 변경은 시각 포함.비어 있는 경우: 알려진 날짜가 없음 |
"2015-07-28" |
위와 같음 |
| management[].meta.end_datenull | 관계의 종료. 목록은 현재 관계를 보여 주므로 null이에요. |
null |
위와 같음 |
| management[].effective_end_datenull | 관계의 종료. 목록은 현재 관계를 보여 주므로 null이에요. |
null |
위와 같음 |
| management[].end_reasonnull | 관계가 끝난 이유. 목록은 현재 관계를 보여 주므로 null이에요. |
null |
위와 같음 |
| management[].meta.lineage_kindstring |
회사 간 관계에만: 거래의 종류.값: TRANSFORMATION_MERGER 합병, TRANSFORMATION_SPLIT 분할, ENTERPRISE_AGREEMENT 기업 계약, GROUP_ENTERPRISE_AGREEMENT 그룹 내 기업 계약, SQUEEZE_OUT 소수 주주 축출(squeeze-out) |
– | 드묾 |
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "management": [5 {6 "relation_label": "MANAGING_DIRECTOR",7 "label": {8 "de": "Geschäftsführer",9 "en": "Managing Director"10 },11 "full_name": "Max Felix Mustermann",12 "meta": {13 "start_date": "2015-07-28",14 "end_date": null15 },16 "effective_end_date": null,17 "end_reason": null18 },19 {20 "relation_label": "MANAGING_DIRECTOR",21 "label": {22 "de": "Geschäftsführer",23 "en": "Managing Director"24 },25 "full_name": "Paul Musterwald",26 "meta": {27 "start_date": "2019-01-04",28 "end_date": null29 },30 "effective_end_date": null,31 "end_reason": null32 },33 {34 "relation_label": "MANAGING_DIRECTOR",35 "label": {36 "de": "Geschäftsführer",37 "en": "Managing Director"38 },39 "full_name": "Jan Musterhuber",40 "meta": {41 "start_date": "2019-01-04",42 "end_date": null43 },44 "effective_end_date": null,45 "end_reason": null46 }47 ]48}
인물의 네트워크
인물 프로필도 같은 기능을 제공해요. 거기서는 인물이 중심에 있고, 필드는 여기와 같아요.