Trovare amministratori e soci

Chi rappresenta un’azienda e chi la possiede.

1

Recuperare la direzione

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --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 · Risposta di esempio: direzione di Hetzner Online GmbH (estratto)
label
label Significato
MANAGING_DIRECTOR Amministratore (Geschäftsführer)
BOARD Membro del consiglio di gestione (Vorstand)
PROCURA Titolare di Prokura (Prokurist); la Prokura è la procura commerciale iscritta nel registro
FULLY_LIABLE_PARTNER Socio a responsabilità illimitata (Komplementär)
LIMITED_PARTNER Socio accomandante (Kommanditist)
LIQUIDATOR Liquidatore di una società in liquidazione
OWNER Titolare di un’impresa individuale
Con Tempo reale (realtime_mode=handelsregister-default) le persone attualmente iscritte arrivano direttamente dall’Handelsregister (registro delle imprese) e non paghi la feature. Tempo reale costa 10 crediti non appena il recupero riesce, qualunque cosa restituisca. Queste voci hanno entity_id propri e nessuna data di inizio. Se il recupero in diretta fallisce, l’API restituisce i dati salvati. _realtime_mode.status allora non è success e Tempo reale non viene addebitato. Se la richiesta dura troppo, ricevi HTTP 408 senza costi; riprova più tardi.
2

Recuperare i soci

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --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 · Risposta di esempio: soci di Hetzner Online GmbH
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --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 · Risposta di esempio: Soci approfonditi di Hetzner Online GmbH (estratto)
3

Trovare i titolari effettivi

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --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 · Risposta di esempio per OroraTech GmbH; nella nostra richiesta di esempio molte quote sono detenute da società estere o da KG e restano non risolte
reason
reason Significato
unlinked Il socio è una società che non riusciamo ad abbinare a un’iscrizione nell’Handelsregister tedesco, di solito una società estera. Non ne conosciamo i soci, quindi la catena finisce qui.
no_further_shareholder_data Conosciamo la società, ma per essa non esiste un elenco soci, ad esempio per una KG.
cycle La catena riporta a una società che vi compare già, ad esempio quando una società detiene quote proprie.
unknown Del socio non si sa nulla, né il nome né la quota.
Leggiamo questi dati automaticamente dagli elenchi soci pubblicati. Usiamo la tecnologia più recente e investiamo molto nella qualità; singoli errori restano comunque possibili. Per verifiche vincolanti scarica l’elenco soci come documento.
4

Recuperare un profilo persona

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --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 · Risposta di esempio per Max Mustermann presso Hetzner Online GmbH (dati di esempio)
Una richiesta dura spesso da dieci a trenta secondi, perché ricerchiamo la persona anche sul web. Imposta il timeout del tuo client ad almeno 120 secondi.

Avanti