العثور على المديرين والشركاء

من يمثّل الشركة ومن يملكها.

1

جلب الإدارة

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4' \
  --data-urlencode 'feature=related_persons'
1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "related_persons": {5    "current": [6      {7        "entity_id": "ea3a1670232611a992727ed067216d07",8        "label": "MANAGING_DIRECTOR",9        "role": {10          "en": {11            "long": "Managing Director",12            "short": "MD"13          },14          "de": {15            "long": "Geschäftsführer",16            "short": "GF"17          }18        },19        "name": "Paul Musterwald",20        "start_date": "2019-01-04",21        "end_date": null,22        "birth_date": "1989-07-18",23        "name_parts": {24          "given": "Paul",25          "family": "Musterwald",26          "maiden": null,27          "canonical_name": "Musterwald, Paul",28          "previous_names": null29        },30        "location": {31          "home": {32            "city": "Exempelingen i. Bay."33          }34        },35        "organization_representation_scheme": {36          "current": [37            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."38          ],39          "history": [40            {41              "value": [42                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."43              ],44              "effective_from": "2002-10-15",45              "effective_to": "2015-07-28"46            },47            {48              "value": [49                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."50              ],51              "effective_from": "2015-07-28",52              "effective_to": null53            }54          ]55        },56        "role_representation_scheme": {57          "current": [58            "einzelvertretungsberechtigt."59          ],60          "history": [61            {62              "value": [63                "einzelvertretungsberechtigt."64              ],65              "effective_from": "2019-01-04",66              "effective_to": null67            }68          ]69        }70      },71      {72        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",73        "label": "MANAGING_DIRECTOR",74        "role": {75          "en": {76            "long": "Managing Director",77            "short": "MD"78          },79          "de": {80            "long": "Geschäftsführer",81            "short": "GF"82          }83        },84        "name": "Jan Musterhuber",85        "start_date": "2019-01-04",86        "end_date": null,87        "birth_date": "1955-11-06",88        "name_parts": {89          "given": "Jan",90          "family": "Musterhuber",91          "maiden": null,92          "canonical_name": "Musterhuber, Jan",93          "previous_names": null94        },95        "location": {96          "home": {97            "city": "Probeingen"98          }99        },100        "organization_representation_scheme": {101          "current": [102            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."103          ],104          "history": [105            {106              "value": [107                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."108              ],109              "effective_from": "2002-10-15",110              "effective_to": "2015-07-28"111            },112            {113              "value": [114                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."115              ],116              "effective_from": "2015-07-28",117              "effective_to": null118            }119          ]120        },121        "role_representation_scheme": {122          "current": [123            "einzelvertretungsberechtigt."124          ],125          "history": [126            {127              "value": [128                "einzelvertretungsberechtigt."129              ],130              "effective_from": "2019-01-04",131              "effective_to": null132            }133          ]134        }135      },136      {137        "entity_id": "08ed5f967956831ca6588930fd2693ed",138        "label": "MANAGING_DIRECTOR",139        "role": {140          "en": {141            "long": "Managing Director",142            "short": "MD"143          },144          "de": {145            "long": "Geschäftsführer",146            "short": "GF"147          }148        },149        "name": "Max Felix Mustermann",150        "start_date": "2015-07-28",151        "end_date": null,152        "birth_date": "1976-01-15",153        "name_parts": {154          "given": "Max Felix",155          "family": "Mustermann",156          "maiden": null,157          "canonical_name": "Mustermann, Max Felix",158          "previous_names": null159        },160        "location": {161          "home": {162            "city": "Musterheim"163          }164        },165        "organization_representation_scheme": {166          "current": [167            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."168          ],169          "history": [170            {171              "value": [172                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."173              ],174              "effective_from": "2002-10-15",175              "effective_to": "2015-07-28"176            },177            {178              "value": [179                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."180              ],181              "effective_from": "2015-07-28",182              "effective_to": null183            }184          ]185        },186        "role_representation_scheme": {187          "current": [188            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."189          ],190          "history": [191            {192              "value": [193                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."194              ],195              "effective_from": "2015-07-28",196              "effective_to": null197            }198          ]199        }200      }201    ],202    "past": [203      {204        "entity_id": "ea3a1670232611a992727ed067216d07",205        "label": "PROCURA",206        "role": {207          "en": {208            "long": "Procura",209            "short": "Procura"210          },211          "de": {212            "long": "Prokura",213            "short": "Prokura"214          }215        },216        "name": "Paul Musterwald",217        "start_date": "2015-07-28",218        "end_date": "2019-01-04",219        "birth_date": "1989-07-18",220        "name_parts": {221          "given": "Paul",222          "family": "Musterwald",223          "maiden": null,224          "canonical_name": "Musterwald, Paul",225          "previous_names": null226        },227        "location": {228          "home": {229            "city": "Exempelingen i. Bay."230          }231        },232        "organization_representation_scheme": {233          "latest": [234            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."235          ],236          "history": [237            {238              "value": [239                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."240              ],241              "effective_from": "2002-10-15",242              "effective_to": "2015-07-28"243            },244            {245              "value": [246                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."247              ],248              "effective_from": "2015-07-28",249              "effective_to": null250            }251          ]252        },253        "role_representation_scheme": {254          "latest": [255            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"256          ],257          "history": [258            {259              "value": [260                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"261              ],262              "effective_from": "2015-07-28",263              "effective_to": "2019-01-04"264            }265          ]266        }267      },268      {269        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",270        "label": "PROCURA",271        "role": {272          "en": {273            "long": "Procura",274            "short": "Procura"275          },276          "de": {277            "long": "Prokura",278            "short": "Prokura"279          }280        },281        "name": "Jan Musterhuber",282        "start_date": "2015-07-28",283        "end_date": "2019-01-04",284        "birth_date": "1955-11-06",285        "name_parts": {286          "given": "Jan",287          "family": "Musterhuber",288          "maiden": null,289          "canonical_name": "Musterhuber, Jan",290          "previous_names": null291        },292        "location": {293          "home": {294            "city": "Probeingen"295          }296        },297        "organization_representation_scheme": {298          "latest": [299            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."300          ],301          "history": [302            {303              "value": [304                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."305              ],306              "effective_from": "2002-10-15",307              "effective_to": "2015-07-28"308            },309            {310              "value": [311                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."312              ],313              "effective_from": "2015-07-28",314              "effective_to": null315            }316          ]317        },318        "role_representation_scheme": {319          "latest": [320            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"321          ],322          "history": [323            {324              "value": [325                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"326              ],327              "effective_from": "2015-07-28",328              "effective_to": "2019-01-04"329            }330          ]331        }332      },333      {334        "entity_id": "08ed5f967956831ca6588930fd2693ed",335        "label": "BOARD",336        "role": {337          "en": {338            "long": "Board Member",339            "short": "Board"340          },341          "de": {342            "long": "Vorstandsmitglied",343            "short": "Vorstand"344          }345        },346        "name": "Max Felix Mustermann",347        "start_date": "2002-10-15",348        "end_date": "2015-07-28",349        "birth_date": "1976-01-15",350        "name_parts": {351          "given": "Max Felix",352          "family": "Mustermann",353          "maiden": null,354          "canonical_name": "Mustermann, Max Felix",355          "previous_names": null356        },357        "location": {358          "home": {359            "city": "Musterheim"360          }361        },362        "organization_representation_scheme": {363          "latest": [364            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."365          ],366          "history": [367            {368              "value": [369                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."370              ],371              "effective_from": "2002-10-15",372              "effective_to": "2015-07-28"373            },374            {375              "value": [376                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."377              ],378              "effective_from": "2015-07-28",379              "effective_to": null380            }381          ]382        },383        "role_representation_scheme": {384          "latest": [385            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"386          ],387          "history": [388            {389              "value": [390                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"391              ],392              "effective_from": "2002-10-15",393              "effective_to": "2015-07-28"394            }395          ]396        }397      }398    ]399  },400  "meta": {401    "request_credit_cost": 7,402    "credits_remaining": 145403  }404}
200 · مثال على استجابة: إدارة Hetzner Online GmbH (مقتطف)
label
label المعنى
MANAGING_DIRECTOR مدير (Geschäftsführer)
BOARD عضو مجلس الإدارة (Vorstand)
PROCURA حامل Prokura (Prokurist)؛ وProkura هي التوكيل المقيّد في السجل
FULLY_LIABLE_PARTNER شريك متضامن بمسؤولية شخصية (Komplementär)
LIMITED_PARTNER شريك موصٍ (Kommanditist)
LIQUIDATOR مصفّي شركة قيد التصفية
OWNER مالك منشأة فردية
مع الوقت الفعلي (realtime_mode=handelsregister-default) يأتي الأشخاص المسجلون حاليًا مباشرةً من السجل التجاري (Handelsregister)، ولا تدفع مقابل الميزة. يكلّف الوقت الفعلي 10 رصيد بمجرد نجاح الجلب، بغض النظر عما يُرجعه. لهذه الإدخالات معرّفات entity_id خاصة بها ولا تاريخ بداية لها. إذا فشل الجلب المباشر، تُرجع الـ API البيانات المخزنة. حينها لا يكون _realtime_mode.status بقيمة success، ولا يُحتسب الوقت الفعلي. وإذا استغرق الطلب وقتًا طويلًا جدًا، تحصل على HTTP 408 دون تكلفة؛ حاول مرة أخرى لاحقًا.
2

جلب الشركاء

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Ansbach HRB 6089' \
  --data-urlencode 'feature=shareholders'
1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholders": {5    "total_capital": {6      "amount": 50000,7      "currency": "EUR"8    },9    "entries": [10      {11        "shareholder": {12          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",13          "entity_name": "ENSoXX GmbH",14          "address": "Gunzenhausen",15          "country_code": "DEU",16          "registration_reference": "AG Ansbach HRB 6105"17        },18        "contribution": {19          "amount": 47250,20          "currency": "EUR"21        },22        "contribution_ratio": 0.945,23        "role": {24          "label": "SHAREHOLDER",25          "en": {26            "long": "Shareholder",27            "short": "Shareholder"28          },29          "de": {30            "long": "Gesellschafter",31            "short": "Gesellschafter"32          }33        }34      },35      {36        "shareholder": {37          "entity_id": "08ed5f967956831ca6588930fd2693ed",38          "first_name": "Max Felix",39          "last_name": "Mustermann",40          "birth_date": "1976-01-15",41          "address": "Musterweg 36 in 36077 Musterheim"42        },43        "contribution": {44          "amount": 2750,45          "currency": "EUR"46        },47        "contribution_ratio": 0.055,48        "role": {49          "label": "SHAREHOLDER",50          "en": {51            "long": "Shareholder",52            "short": "Shareholder"53          },54          "de": {55            "long": "Gesellschafter",56            "short": "Gesellschafter"57          }58        }59      }60    ],61    "history": {62      "current_as_of": "2015-08-21",63      "past": [64        {65          "as_of": "2015-07-28",66          "data": {67            "total_capital": {68              "amount": 50000,69              "currency": "EUR"70            },71            "shareholders": [72              {73                "shareholder": {74                  "entity_id": "08ed5f967956831ca6588930fd2693ed",75                  "first_name": "Max",76                  "last_name": "Mustermann",77                  "birth_date": "1976-01-15",78                  "address": "Musterweg 36 in 36077 Musterheim"79                },80                "contribution": {81                  "amount": 50000,82                  "currency": "EUR"83                },84                "contribution_ratio": 1,85                "role": {86                  "label": "SHAREHOLDER",87                  "en": {88                    "long": "Shareholder",89                    "short": "Shareholder"90                  },91                  "de": {92                    "long": "Gesellschafter",93                    "short": "Gesellschafter"94                  }95                }96              }97            ]98          }99        }100      ]101    }102  },103  "meta": {104    "request_credit_cost": 10,105    "credits_remaining": 145106  }107}
200 · مثال على استجابة: شركاء Hetzner Online GmbH
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Ansbach HRB 6089' \
  --data-urlencode 'feature=shareholders_deep'
1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholders_deep": {5    "record": {6      "date": "2015-08-18",7      "source": "SHAREHOLDER_LIST"8    },9    "share_capital": {10      "value": 50000,11      "currency": "EUR",12      "basis": "REPORTED"13    },14    "entries": [15      {16        "holder": {17          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",18          "type": "ORGANIZATION",19          "name": "ENSoXX GmbH",20          "legal_form": "GmbH",21          "status": "ACTIVE",22          "city": "Gunzenhausen",23          "country": "DEU",24          "registration": {25            "court": "Ansbach",26            "register_type": "HRB",27            "register_number": "6105"28          },29          "registration_text": null30        },31        "role": "SHAREHOLDER",32        "ownership": {33          "percentage": 94.5,34          "percentage_basis": "REPORTED",35          "nominal_amount": {36            "value": 47250,37            "currency": "EUR"38          },39          "share_count": 47250,40          "share_ranges": [41            {42              "from": 1,43              "to": 47250,44              "count": 47250,45              "nominal_value": {46                "value": 1,47                "currency": "EUR"48              }49            }50          ]51        },52        "since": "2015-08-18",53        "since_basis": "ENTRY_RECORDED"54      },55      {56        "holder": {57          "entity_id": "08ed5f967956831ca6588930fd2693ed",58          "type": "PERSON",59          "name": "Max Felix Mustermann",60          "birth_date": "1976-01-15",61          "city": "Musterheim",62          "country": "DEU"63        },64        "role": "SHAREHOLDER",65        "ownership": {66          "percentage": 5.5,67          "percentage_basis": "REPORTED",68          "nominal_amount": {69            "value": 2750,70            "currency": "EUR"71          },72          "share_count": 2750,73          "share_ranges": [74            {75              "from": 47251,76              "to": 50000,77              "count": 2750,78              "nominal_value": {79                "value": 1,80                "currency": "EUR"81              }82            }83          ]84        },85        "since": "2015-07-16",86        "since_basis": "EARLIEST_RECORD"87      }88    ],89    "history": [90      {91        "record": {92          "date": "2015-07-16",93          "source": "SHAREHOLDER_LIST"94        },95        "share_capital": {96          "value": 50000,97          "currency": "EUR",98          "basis": "REPORTED"99        },100        "entries": [101          {102            "holder": {103              "entity_id": "08ed5f967956831ca6588930fd2693ed",104              "type": "PERSON",105              "name": "Max Mustermann",106              "birth_date": "1976-01-15",107              "city": null,108              "country": null109            },110            "role": "SHAREHOLDER",111            "ownership": {112              "percentage": 100,113              "percentage_basis": "REPORTED",114              "nominal_amount": {115                "value": 50000,116                "currency": "EUR"117              },118              "share_count": 50000,119              "share_ranges": [120                {121                  "from": 1,122                  "to": 50000,123                  "count": 50000,124                  "nominal_value": {125                    "value": 1,126                    "currency": "EUR"127                  }128                }129              ]130            },131            "since": "2015-07-16",132            "since_basis": "EARLIEST_RECORD"133          }134        ]135      }136    ],137    "changes": {138      "compared_to": "2015-07-16",139      "joined": [140        {141          "holder": {142            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",143            "type": "ORGANIZATION",144            "name": "ENSoXX GmbH"145          },146          "percentage": 94.5147        }148      ],149      "left": [],150      "changed": [151        {152          "holder": {153            "entity_id": "08ed5f967956831ca6588930fd2693ed",154            "type": "PERSON",155            "name": "Max Felix Mustermann"156          },157          "percentage_before": 100,158          "percentage_after": 5.5159        }160      ]161    }162  },163  "meta": {164    "request_credit_cost": 85,165    "credits_remaining": 145166  }167}
200 · مثال على استجابة: المساهمون بالتفصيل لـ Hetzner Online GmbH (مقتطف)
3

العثور على المستفيدين الحقيقيين

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=OroraTech GmbH' \
  --data-urlencode 'feature=ubos'
1{2  "entity_id": "82a68ab9f7151fa0af9bf189c1caa753",3  "name": "OroraTech GmbH",4  "ubos": {5    "beneficial_owners": [6      {7        "person": {8          "entity_id": "99e133f16ed20bbe874dfb08f87f2e54",9          "name": "Ben Probeberg",10          "birth_date": "1998-05-15",11          "name_parts": {12            "given": "Ben",13            "family": "Probeberg",14            "canonical_name": "Probeberg, Ben"15          },16          "location": {17            "home": {18              "city": "Probestadt",19              "county": "Probestadt (Stadt)",20              "state": "Bayern",21              "country": "DEU"22            }23          }24        },25        "ownership_percentage": 6.3,26        "paths": [27          {28            "percentage": 6.3,29            "via": [30              {31                "depth": 1,32                "name": "Gruebler Ventures UG (haftungsbeschränkt)",33                "entity_id": "8ad5472dd9d7ebc41f36da4ef69bb3a5",34                "step_percentage": 6.335              }36            ]37          }38        ]39      },40      {41        "person": {42          "entity_id": "294824cad5ca0128c27b80ebe4658e02",43          "name": "Otto Beispielbach",44          "birth_date": "1990-05-14",45          "name_parts": {46            "given": "Otto",47            "family": "Beispielbach",48            "canonical_name": "Beispielbach, Otto"49          },50          "location": {51            "home": {52              "city": "Probestadt",53              "county": "Probestadt (Stadt)",54              "state": "Bayern",55              "country": "DEU"56            }57          }58        },59        "ownership_percentage": 3.04,60        "paths": [61          {62            "percentage": 3.04,63            "via": [64              {65                "depth": 1,66                "name": "Stoffers Capital UG (haftungsbeschränkt)",67                "entity_id": "85210409b2baa963c92fd96bfe5b1c4f",68                "step_percentage": 3.0469              }70            ]71          }72        ]73      },74      {75        "person": {76          "entity_id": "cf4f3147eeaf4875d4020854f1c05ca5",77          "name": "Gunnar Beispielberg",78          "birth_date": "1997-04-21",79          "name_parts": {80            "given": "Gunnar",81            "family": "Beispielberg",82            "canonical_name": "Beispielberg, Gunnar"83          },84          "location": {85            "home": {86              "city": "Exempelkirchen b. Probestadt",87              "county": "Probestadt (Landkreis)",88              "state": "Bayern",89              "country": "DEU"90            }91          }92        },93        "ownership_percentage": 2.97,94        "paths": [95          {96            "percentage": 2.97,97            "via": []98          }99        ]100      },101      {102        "person": {103          "entity_id": "dbcaeae2179be548c1affb1a59b9acc5",104          "name": "Niklas Jan Exempel",105          "birth_date": "1985-06-09",106          "name_parts": {107            "given": "Niklas Jan",108            "family": "Exempel",109            "canonical_name": "Exempel, Niklas Jan"110          },111          "location": {112            "home": {113              "city": "Probestadt",114              "county": "Probestadt (Stadt)",115              "state": "Bayern",116              "country": "DEU"117            }118          }119        },120        "ownership_percentage": 2.97,121        "paths": [122          {123            "percentage": 2.97,124            "via": []125          }126        ]127      },128      {129        "person": {130          "entity_id": "39cd92d732b550604f585f48a9da16ef",131          "name": "Lars Probefeld",132          "birth_date": "1961-02-04",133          "name_parts": {134            "given": "Lars",135            "family": "Probefeld",136            "canonical_name": "Dr. Probefeld, Lars"137          },138          "location": {139            "home": {140              "city": "Exempelhain",141              "county": "Probestadt (Landkreis)",142              "state": "Bayern",143              "country": "DEU"144            }145          }146        },147        "ownership_percentage": 0.52,148        "paths": [149          {150            "percentage": 0.52,151            "via": []152          }153        ]154      },155      {156        "person": {157          "entity_id": null,158          "name": "Till Dieter Mustergut",159          "birth_date": "1963-06-05",160          "name_parts": {161            "given": "Till Dieter",162            "family": "Mustergut"163          },164          "location": null165        },166        "ownership_percentage": 0.48,167        "paths": [168          {169            "percentage": 0.48,170            "via": [171              {172                "depth": 1,173                "name": "SpaceTec Capital GmbH",174                "entity_id": "bb1085469dfe9fd0c2e31f1bac4b9767",175                "step_percentage": 0.48176              }177            ]178          }179        ]180      },181      {182        "person": {183          "entity_id": "960bf144c3eda5c99e3caab086644da1",184          "name": "Jan Probemann",185          "birth_date": "1968-07-22",186          "name_parts": {187            "given": "Jan",188            "family": "Probemann",189            "canonical_name": "Dr. Probemann, Jan"190          },191          "location": {192            "home": {193              "city": "Probekirchen",194              "county": "Probekirchen",195              "state": "Nordrhein-Westfalen",196              "country": "DEU"197            }198          }199        },200        "ownership_percentage": 0.45,201        "paths": [202          {203            "percentage": 0.45,204            "via": []205          }206        ]207      },208      {209        "person": {210          "entity_id": null,211          "name": "Ansgar Beispielbach",212          "birth_date": "1986-07-12",213          "name_parts": {214            "given": "Ansgar",215            "family": "Beispielbach"216          },217          "location": null218        },219        "ownership_percentage": 0.14,220        "paths": [221          {222            "percentage": 0.14,223            "via": []224          }225        ]226      },227      {228        "person": {229          "entity_id": "9792b6bfd69854a5b19739fea1ea823e",230          "name": "Oskar Musterbrink",231          "birth_date": "1977-08-04",232          "name_parts": {233            "given": "Oskar",234            "family": "Musterbrink",235            "canonical_name": "Musterbrink, Oskar"236          },237          "location": {238            "home": {239              "city": "Probestadt",240              "county": "Probestadt (Stadt)",241              "state": "Bayern",242              "country": "DEU"243            }244          }245        },246        "ownership_percentage": 0.11,247        "paths": [248          {249            "percentage": 0.11,250            "via": []251          }252        ]253      },254      {255        "person": {256          "entity_id": "ec1fada353aa68303cb963369161928a",257          "name": "Rainer Beispielfeld",258          "birth_date": "1995-02-21",259          "name_parts": {260            "given": "Rainer",261            "family": "Beispielfeld",262            "canonical_name": "Beispielfeld, Rainer"263          },264          "location": {265            "home": {266              "city": "Probestadt",267              "county": "Probestadt (Stadt)",268              "state": "Bayern",269              "country": "DEU"270            }271          }272        },273        "ownership_percentage": 0.11,274        "paths": [275          {276            "percentage": 0.11,277            "via": []278          }279        ]280      },281      {282        "person": {283          "entity_id": "f08c9fbac5f16a37518e63683e007a6d",284          "name": "Felix Klaus Max Beispielberg",285          "birth_date": "1967-07-25",286          "name_parts": {287            "given": "Felix Klaus Max",288            "family": "Beispielberg",289            "canonical_name": "Beispielberg, Felix Klaus Max"290          },291          "location": {292            "home": {293              "city": "Musterbach",294              "county": "Musterbach (Stadt)",295              "state": "Bayern",296              "country": "DEU"297            }298          }299        },300        "ownership_percentage": 0.03,301        "paths": [302          {303            "percentage": 0.03,304            "via": []305          }306        ]307      }308    ],309    "unresolved_beneficial_owners": [310      {311        "reason": "no_further_shareholder_data",312        "entity_id": "0aedd216ca3a22f0204667d552fe0c82",313        "name": "ConActivity KG",314        "legal_form": "KG",315        "address": {316          "house_number": "12",317          "street": "Siesmayerstr.",318          "postal_code": "60323",319          "city": "Frankfurt am Main",320          "county": "Frankfurt am Main",321          "state": "Hessen",322          "country": "DEU",323          "coordinates": {324            "latitude": 50.12033,325            "longitude": 8.65979326          }327        },328        "registration": {329          "court": "Frankfurt am Main",330          "register_type": "HRA",331          "register_number": "30787"332        },333        "ownership_percentage": 10.53,334        "via": []335      },336      {337        "reason": "unlinked",338        "entity_id": null,339        "name": "Korys Investments N.V.",340        "legal_form": null,341        "address": {342          "country": "BEL"343        },344        "registration": [],345        "ownership_percentage": 9.96,346        "via": []347      },348      {349        "reason": "no_further_shareholder_data",350        "entity_id": "697760968fea213b6a4b984b564b7cea",351        "name": "Wachstumsfonds Bayern 2 GmbH & Co. KG",352        "legal_form": "GmbH & Co. KG",353        "address": {354          "house_number": "135 a",355          "street": "Ländgasse",356          "postal_code": "84028",357          "city": "Landshut",358          "county": "Landshut (Stadt)",359          "state": "Bayern",360          "country": "DEU",361          "coordinates": {362            "latitude": 48.53551,363            "longitude": 12.1501364          }365        },366        "registration": {367          "court": "Landshut",368          "register_type": "HRA",369          "register_number": "11924"370        },371        "ownership_percentage": 9.52,372        "via": []373      },374      {375        "reason": "no_further_shareholder_data",376        "entity_id": "3835ff8711f539231fd912f976a68c85",377        "name": "Ananda Impact Fund III GmbH & Co. KG",378        "legal_form": "GmbH & Co. KG",379        "address": {380          "house_number": "6",381          "street": "Isarwinkel",382          "postal_code": "81379",383          "city": "München",384          "county": "München (Stadt)",385          "state": "Bayern",386          "country": "DEU",387          "coordinates": {388            "latitude": 48.09599,389            "longitude": 11.54402390          }391        },392        "registration": {393          "court": "München",394          "register_type": "HRA",395          "register_number": "107669"396        },397        "ownership_percentage": 8.92,398        "via": []399      },400      {401        "reason": "unlinked",402        "entity_id": null,403        "name": "Edaphon SRL",404        "legal_form": null,405        "address": {406          "country": "BEL"407        },408        "registration": {409          "court": "Handelsregister
Brüssel",410          "register_type": "BE",411          "register_number": "0787.533.694"412        },413        "ownership_percentage": 8.54,414        "via": []415      },416      {417        "reason": "unlinked",418        "entity_id": null,419        "name": "ECBF I SCSp",420        "legal_form": null,421        "address": {422          "country": "LUX"423        },424        "registration": {425          "court": "Handels- und Ge-
sellschaftsregister
von Luxemburg
(Registre de
Commerce et des
Sociétés)",426          "register_type": "B",427          "register_number": "245576"428        },429        "ownership_percentage": 8.34,430        "via": []431      },432      {433        "reason": "no_further_shareholder_data",434        "entity_id": "38b7ed49ae75c55cd4e98958c2765e1f",435        "name": "ScaleUp-Fonds Bayern GmbH & Co. KG",436        "legal_form": "GmbH & Co. KG",437        "address": {438          "house_number": "135 a",439          "street": "Ländgasse",440          "postal_code": "84028",441          "city": "Landshut",442          "county": "Landshut (Stadt)",443          "state": "Bayern",444          "country": "DEU",445          "coordinates": {446            "latitude": 48.53551,447            "longitude": 12.1501448          }449        },450        "registration": {451          "court": "Landshut",452          "register_type": "HRA",453          "register_number": "12153"454        },455        "ownership_percentage": 7.1,456        "via": []457      },458      {459        "reason": "unlinked",460        "entity_id": null,461        "name": "BNP Paribas Solar Impulse Venture Fund SLP",462        "legal_form": null,463        "address": {464          "country": "FRA"465        },466        "registration": {467          "court": "Unternehmensregister von Frankreich (Registre national des entreprises)",468          "register_type": "912",469          "register_number": "234 911"470        },471        "ownership_percentage": 6.4,472        "via": []473      },474      {475        "reason": "unlinked",476        "entity_id": null,477        "name": "Findus Venture GmbH",478        "legal_form": null,479        "address": {480          "country": "AUT"481        },482        "registration": {483          "court": "Firmenbuch Wien",484          "register_type": "FN",485          "register_number": "493001b"486        },487        "ownership_percentage": 6.25,488        "via": []489      },490      {491        "reason": "cycle",492        "entity_id": "82a68ab9f7151fa0af9bf189c1caa753",493        "name": "OroraTech GmbH",494        "legal_form": "GmbH",495        "address": {496          "house_number": "112",497          "street": "St.-Martin-Straße",498          "postal_code": "81669",499          "city": "München",500          "county": "München (Stadt)",501          "state": "Bayern",502          "country": "DEU",503          "coordinates": {504            "latitude": 48.13641,505            "longitude": 11.57754506          }507        },508        "registration": {509          "court": "München",510          "register_type": "HRB",511          "register_number": "243843"512        },513        "ownership_percentage": 2.64,514        "via": []515      },516      {517        "reason": "unlinked",518        "entity_id": null,519        "name": "APEX One Best in Class EuVECA GmbH & Co KG",520        "legal_form": null,521        "address": {522          "country": "AUT"523        },524        "registration": {525          "court": "Firmenbuch
Wien",526          "register_type": "FN",527          "register_number": "559371f"528        },529        "ownership_percentage": 1.57,530        "via": []531      },532      {533        "reason": "unlinked",534        "entity_id": null,535        "name": "Rabo Ventures B.V.",536        "legal_form": null,537        "address": {538          "country": "NLD"539        },540        "registration": {541          "court": "Handelsregister
der Niederlande",542          "register_type": "KvK-Nummer",543          "register_number": "34285559"544        },545        "ownership_percentage": 1.5,546        "via": []547      },548      {549        "reason": "unlinked",550        "entity_id": null,551        "name": "APEX Ventures EuVECA GmbH & Co. KG",552        "legal_form": null,553        "address": {554          "country": "AUT"555        },556        "registration": {557          "court": "Firmenbuch Wien",558          "register_type": "FN",559          "register_number": "460075g"560        },561        "ownership_percentage": 1.21,562        "via": []563      },564      {565        "reason": "unlinked",566        "entity_id": null,567        "name": "Earth Sciences Foundation",568        "legal_form": null,569        "address": {570          "country": "USA"571        },572        "registration": [],573        "ownership_percentage": 0.39,574        "via": []575      }576    ],577    "coverage": {578      "resolved_percentage": 17.12,579      "unresolved_percentage": 82.87580    }581  },582  "meta": {583    "request_credit_cost": 15,584    "credits_remaining": 145585  }586}
200 · مثال على استجابة لـ OroraTech GmbH؛ في طلبنا النموذجي تملك شركات في الخارج أو شركات KG كثيرًا من الحصص وتبقى غير محلولة
reason
reason المعنى
unlinked الشريك شركة لا نستطيع مطابقتها مع قيد في السجل التجاري الألماني، وعادةً شركة في الخارج. لا نعرف شركاءها، لذا تنتهي السلسلة هنا.
no_further_shareholder_data نعرف الشركة، لكن لا توجد لها قائمة شركاء، مثلًا لـ KG.
cycle تعود السلسلة إلى شركة تظهر فيها بالفعل، مثلًا عندما تملك شركة حصصها الخاصة.
unknown لا شيء معروف عن الشريك، لا الاسم ولا الحصة.
نقرأ هذه البيانات آليًا من قوائم الشركاء المنشورة. نستخدم لذلك أحدث التقنيات ونستثمر كثيرًا في الجودة؛ ومع ذلك تبقى أخطاء فردية ممكنة. وللفحوص الملزمة نزّل قائمة الشركاء كـ مستند.
4

جلب ملف شخص

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'person_q=Max Mustermann' \
  --data-urlencode 'organization_q=Hetzner Online GmbH'
1{2  "entity_id": "08ed5f967956831ca6588930fd2693ed",3  "name": "Max Felix Mustermann",4  "birth_date": "1976-01-15",5  "name_parts": {6    "given": "Max Felix",7    "family": "Mustermann",8    "maiden": null,9    "canonical_name": "Mustermann, Max Felix",10    "previous_names": null11  },12  "location": {13    "home": {14      "city": "Musterheim"15    }16  },17  "bio": "Max Felix Mustermann ist Geschäftsführer der Hetzner Online GmbH und Unternehmer im Bereich Rechenzentren.",18  "expertise": [19    "Rechenzentren",20    "Hosting"21  ],22  "contact": {23    "emails": [24      {25        "address": "[email protected]",26        "type": "organization",27        "label": "Allgemeine Unternehmenskontakt-E-Mail"28      },29      {30        "address": "[email protected]",31        "type": "organization",32        "label": "E-Mail für Produktfeedback"33      }34    ],35    "phones": [36      {37        "number": "+49374574447100",38        "type": "organization",39        "entity": "Hetzner Online GmbH",40        "label": "Öffentliche Unternehmens-Telefonnummer"41      },42      {43        "number": "+49911234226100",44        "type": "organization",45        "entity": "Hetzner Online GmbH",46        "label": "Öffentliche Unternehmens-Telefonnummer"47      },48      {49        "number": "+4998315050",50        "type": "organization",51        "entity": "Hetzner Online GmbH",52        "label": "Zentrale Unternehmensnummer"53      }54    ]55  },56  "profiles": {57    "linkedin": null,58    "other": []59  },60  "affiliations": [61    {62      "organization": "ENSoXX Holding AG",63      "relation": "Vorstandsmitglied"64    },65    {66      "organization": "Hetzner Online GmbH",67      "relation": "Geschäftsführer"68    },69    {70      "organization": "ENSoXX hilft e.V.",71      "relation": "Vorstandsmitglied"72    },73    {74      "organization": "TRAIDY UG (haftungsbeschränkt)",75      "relation": "Geschäftsführer"76    },77    {78      "organization": "HT clean energy GmbH",79      "relation": "Geschäftsführer"80    },81    {82      "organization": "DreamSoXX GmbH",83      "relation": "Geschäftsführer"84    },85    {86      "organization": "Lighthouse GmbH",87      "relation": "Prokura"88    },89    {90      "organization": "ENSoXX GmbH",91      "relation": "Geschäftsführer"92    },93    {94      "organization": "ENSoXX Invest GmbH",95      "relation": "Geschäftsführer"96    },97    {98      "organization": "Sonnenkraft Merkendorf GmbH & Co. KG",99      "relation": "Kommanditist"100    },101    {102      "organization": "Modellsportclub Gunzenhausen e.V.",103      "relation": "Vorstandsmitglied"104    },105    {106      "organization": "possum Projekt 1 GmbH",107      "relation": "Prokura"108    }109  ],110  "handelsregister_roles": [111    {112      "entity_id": "94eb910fef13f94585c48c263fa446d4",113      "name": "Hetzner Online GmbH",114      "label": "BOARD",115      "role": {116        "en": "Board Member",117        "de": "Vorstandsmitglied"118      },119      "start_date": "2002-10-15",120      "end_date": "2015-07-28"121    },122    {123      "entity_id": "0b3435f83ce8591300625100815d4583",124      "name": "Hetzner Online GmbH",125      "label": "BOARD",126      "role": {127        "en": "Board Member",128        "de": "Vorstandsmitglied"129      },130      "start_date": "2002-10-15",131      "end_date": "2015-07-28"132    },133    {134      "entity_id": "0b3435f83ce8591300625100815d4583",135      "name": "Hetzner Online GmbH",136      "label": "MANAGING_DIRECTOR",137      "role": {138        "en": "Managing Director",139        "de": "Geschäftsführer"140      },141      "start_date": "2015-07-28",142      "end_date": null143    },144    {145      "entity_id": "94eb910fef13f94585c48c263fa446d4",146      "name": "Hetzner Online GmbH",147      "label": "MANAGING_DIRECTOR",148      "role": {149        "en": "Managing Director",150        "de": "Geschäftsführer"151      },152      "start_date": "2015-07-28",153      "end_date": null154    },155    {156      "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",157      "name": "ENSoXX GmbH",158      "label": "MANAGING_DIRECTOR",159      "role": {160        "en": "Managing Director",161        "de": "Geschäftsführer"162      },163      "start_date": "2015-08-14",164      "end_date": null165    },166    {167      "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",168      "name": "ENSoXX Holding AG",169      "label": "BOARD",170      "role": {171        "en": "Board Member",172        "de": "Vorstandsmitglied"173      },174      "start_date": "2016-02-03",175      "end_date": null176    },177    {178      "entity_id": "bc1c1e106ade810eb960c779d4c752a8",179      "name": "ENSoXX hilft e.V.",180      "label": "BOARD",181      "role": {182        "en": "Board Member",183        "de": "Vorstandsmitglied"184      },185      "start_date": "2017-02-24",186      "end_date": null187    },188    {189      "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",190      "name": "TRAIDY UG (haftungsbeschränkt)",191      "label": "MANAGING_DIRECTOR",192      "role": {193        "en": "Managing Director",194        "de": "Geschäftsführer"195      },196      "start_date": "2022-03-14",197      "end_date": null198    },199    {200      "entity_id": "4cd425f9ad57d6119f704ba53131b480",201      "name": "Modellsportclub Gunzenhausen e.V.",202      "label": "BOARD",203      "role": {204        "en": "Board Member",205        "de": "Vorstandsmitglied"206      },207      "start_date": "2023-06-06",208      "end_date": "2026-08-12"209    },210    {211      "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",212      "name": "ENSoXX Invest GmbH",213      "label": "MANAGING_DIRECTOR",214      "role": {215        "en": "Managing Director",216        "de": "Geschäftsführer"217      },218      "start_date": "2023-12-13",219      "end_date": null220    },221    {222      "entity_id": "2ab71b59057969183dd811adf9f32ebd",223      "name": "HT clean energy GmbH",224      "label": "MANAGING_DIRECTOR",225      "role": {226        "en": "Managing Director",227        "de": "Geschäftsführer"228      },229      "start_date": "2024-08-20",230      "end_date": null231    },232    {233      "entity_id": "260286ab8baa3a8977fddd56b9361c6c",234      "name": "DreamSoXX GmbH",235      "label": "MANAGING_DIRECTOR",236      "role": {237        "en": "Managing Director",238        "de": "Geschäftsführer"239      },240      "start_date": "2025-01-13",241      "end_date": null242    },243    {244      "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",245      "name": "Lighthouse GmbH",246      "label": "PROCURA",247      "role": {248        "en": "Procura",249        "de": "Prokura"250      },251      "start_date": "2025-03-25",252      "end_date": null253    },254    {255      "entity_id": "232d2ed634eef59eb21836cc47cb5645",256      "name": "Sonnenkraft Merkendorf GmbH & Co. KG",257      "label": "LIMITED_PARTNER",258      "role": {259        "en": "Limited Partner",260        "de": "Kommanditist"261      },262      "start_date": "2026-02-18",263      "end_date": null264    },265    {266      "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",267      "name": "possum Projekt 1 GmbH",268      "label": "PROCURA",269      "role": {270        "en": "Procura",271        "de": "Prokura"272      },273      "start_date": "2026-09-04",274      "end_date": null275    },276    {277      "entity_id": "997f1b8314b8b56573208ae2334abb1d",278      "name": "possum Projekt 1 GmbH",279      "label": "PROCURA",280      "role": {281        "en": "Procura",282        "de": "Prokura"283      },284      "start_date": "2026-09-04",285      "end_date": null286    }287  ],288  "meta": {289    "request_credit_cost": 15,290    "credits_remaining": 145291  }292}
200 · مثال على استجابة لـ Max Mustermann لدى Hetzner Online GmbH (بيانات نموذجية)
يستغرق الطلب غالبًا من عشر إلى ثلاثين ثانية، لأننا نبحث عن الشخص على الويب أيضًا. اضبط مهلة الانتظار في عميلك على 120 ثانية على الأقل.

التالي