Geschäftsführer und Gesellschafter ermitteln
Wer eine Firma vertritt und wem sie gehört.
Drei Features zeigen die Menschen hinter einer Firma: die Geschäftsführung, die Gesellschafter und die wirtschaftlich Berechtigten. Zu einer einzelnen Person holst du danach ihr Personenprofil.
Geschäftsführung abrufen
Das Feature related_persons (Geschäftsführung) liefert alle Personen, die im Register für die Firma eingetragen sind. current enthält die aktuellen, past die früheren, jeweils mit Beginn und Ende. Als Beispiel fragen wir die Hetzner Online GmbH, Ansbach HRB 6089, über ihre entity_id an.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4' \ --data-urlencode 'feature=related_persons'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "q": "94eb910fef13f94585c48c263fa446d4", "feature": ["related_persons"], }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4"); url.searchParams.append("feature", "related_persons"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
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}
Die Rolle steht maschinenlesbar in label und als Text in role.de.long. Die häufigsten Werte:
| label | Bedeutung |
|---|---|
| MANAGING_DIRECTOR | Geschäftsführer |
| BOARD | Vorstandsmitglied |
| PROCURA | Prokurist; Prokura ist die im Register eingetragene Vollmacht |
| FULLY_LIABLE_PARTNER | Persönlich haftender Gesellschafter (Komplementär) |
| LIMITED_PARTNER | Kommanditist |
| LIQUIDATOR | Liquidator einer Firma in Auflösung |
| OWNER | Inhaber eines Einzelunternehmens |
Alle Werte stehen unter Werte und Codes.
Wie eine Person die Firma vertreten darf, steht in role_representation_scheme, etwa „einzelvertretungsberechtigt“. Die Regel für die ganze Firma steht in organization_representation_scheme.
related_persons kostet 2 Credits, aber nur, wenn die API Personen findet.
Mit Echtzeit (
realtime_mode=handelsregister-default) kommen die aktuell eingetragenen Personen direkt aus dem Handelsregister, ohne dass du das Feature bezahlst. Echtzeit kostet 10 Credits, sobald der Abruf gelingt, egal was er liefert. Diese Einträge haben eigene entity_ids und kein Beginndatum. Gelingt der Live-Abruf nicht, liefert die API die gespeicherten Daten. _realtime_mode.status ist dann nicht success, und Echtzeit wird nicht berechnet. Dauert die Anfrage zu lange, kommt HTTP 408 ohne Kosten; versuch es später erneut.
Gesellschafter abrufen
Das Feature shareholders (Gesellschafter) liest die Gesellschafterliste, die jede GmbH beim Register einreicht. Du bekommst jeden Gesellschafter mit seiner Einlage und seinem Anteil. Frühere Listen stehen unter history.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'q=Ansbach HRB 6089' \ --data-urlencode 'feature=shareholders'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "q": "Ansbach HRB 6089", "feature": ["shareholders"], }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Ansbach HRB 6089"); url.searchParams.append("feature", "shareholders"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
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}
contribution_ratio ist der Anteil als Bruch, 1 bedeutet 100 %. Er bezieht sich auf das Kapital laut Gesellschafterliste in total_capital. Das eingetragene Kapital steht im Firmenprofil unter capital. In unserer Beispielanfrage hält die ENSoXX GmbH, Ansbach HRB 6105, 94,5 % der Hetzner Online GmbH, eine Person die übrigen 5,5 %.
Bei einer KG stehen Komplementäre und Kommanditisten mit ihrer Rolle in related_persons, teils auch in shareholders. Aktiengesellschaften führen keine öffentliche Gesellschafterliste, dort bleibt shareholders meist leer.
shareholders kostet 5 Credits, aber nur, wenn die API Gesellschafter findet.
Mit Max gibt es shareholders_deep (Tiefe Gesellschafter). Es zeigt jede eingereichte Liste mit Prozent, Nennbetrag und den Nummern der Geschäftsanteile. Unter changes steht, wer gegenüber der vorigen Liste dazukam, ausschied oder seinen Anteil änderte.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'q=Ansbach HRB 6089' \ --data-urlencode 'feature=shareholders_deep'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "q": "Ansbach HRB 6089", "feature": ["shareholders_deep"], }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Ansbach HRB 6089"); url.searchParams.append("feature", "shareholders_deep"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
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}
shareholders_deep kostet 80 Credits, aber nur, wenn die API Einträge findet.
Wirtschaftlich Berechtigte ermitteln
Wirtschaftlich berechtigt ist, wer am Ende hinter einer Firma steht, direkt oder über andere Firmen. Das Feature ubos (Wirtschaftlich Berechtigte) folgt dafür der Kette der Gesellschafterlisten bis zu natürlichen Personen. Hier nehmen wir als Beispiel die OroraTech GmbH, München HRB 243843, weil ihre Kette über viele Stufen läuft.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'q=OroraTech GmbH' \ --data-urlencode 'feature=ubos'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "q": "OroraTech GmbH", "feature": ["ubos"], }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "OroraTech GmbH"); url.searchParams.append("feature", "ubos"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
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}
beneficial_owners nennt jede Person. Ihren Gesamtanteil in Prozent findest du in ownership_percentage. Die Wege dorthin stehen in paths, die Firmen dazwischen in via. coverage zeigt, welcher Anteil des Kapitals bis zu Personen aufgeklärt ist (resolved_percentage) und welcher nicht (unresolved_percentage). Zusammen ergeben beide nicht immer 100 %. Für den Rest nennen die Gesellschafterdaten keinen Inhaber.
Endet eine Kette vor einer natürlichen Person, steht der Anteil in unresolved_beneficial_owners. Oft ist das ein Gesellschafter, der über eine Firma im Ausland beteiligt ist. Wir decken nur deutsche Firmen ab und kennen die Gesellschafter dieser Firma deshalb nicht. Der Grund steht in reason:
| reason | Bedeutung |
|---|---|
| unlinked | Der Gesellschafter ist eine Firma, die wir keinem Eintrag im deutschen Handelsregister zuordnen können, meist eine Firma im Ausland. Ihre Gesellschafter kennen wir nicht, deshalb endet die Kette hier. |
| no_further_shareholder_data | Die Firma ist uns bekannt, aber für sie liegt keine Gesellschafterliste vor, etwa bei einer KG. |
| cycle | Die Kette führt zu einer Firma zurück, die schon in ihr vorkommt, etwa wenn eine Firma eigene Anteile hält. |
| unknown | Über den Gesellschafter ist nichts bekannt, weder Name noch Anteil. |
ubos kostet 10 Credits, sobald der Block Daten enthält. Das gilt auch, wenn er nur ungeklärte Anteile zeigt.
Diese Angaben lesen wir maschinell aus den veröffentlichten Gesellschafterlisten. Wir setzen dafür die neueste Technik ein und investieren viel in die Qualität; einzelne Fehler sind trotzdem möglich. Für verbindliche Prüfungen lädst du die Gesellschafterliste als Dokument.
Personenprofil abrufen
Das Personenprofil (fetch-person) zeigt alle Ämter einer Person im Register. Dazu kommen eine kurze Beschreibung, Fachgebiete und Kontaktwege aus öffentlichen Quellen im Web. Du gibst den Namen der Person und eine Firma an, bei der sie eingetragen ist oder war.
curl -G "https://handelsregister.ai/api/v1/fetch-person" \ -H "x-api-key: DEIN_API_SCHLUESSEL" \ --data-urlencode 'person_q=Max Mustermann' \ --data-urlencode 'organization_q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-person", headers={"x-api-key": "DEIN_API_SCHLUESSEL"}, params={ "person_q": "Max Mustermann", "organization_q": "Hetzner Online GmbH", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-person"); url.searchParams.append("person_q", "Max Mustermann"); url.searchParams.append("organization_q", "Hetzner Online GmbH"); const response = await fetch(url, { headers: { "x-api-key": "DEIN_API_SCHLUESSEL" }, }); const data = await response.json();
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}
Die Firma macht die Person eindeutig, deshalb sind beide Angaben Pflicht. Lässt sich keine Person sicher zuordnen, kommt HTTP 404 ohne Kosten. Ämter stehen in handelsregister_roles, ein leeres end_date heißt: aktuell.
Das Personenprofil gibt es mit einem Credit-Abo ab Plus, es kostet 15 Credits. Mit features=shareholdings kommen die Beteiligungen der Person dazu. Sie kosten 5 Credits, aber nur, wenn es welche gibt.
Eine Anfrage dauert oft zehn bis dreißig Sekunden, weil wir die Person auch im Web recherchieren. Stell den Timeout deines Clients auf mindestens 120 Sekunden.