Personen en vertegenwoordiging – Documentatie

Personen ophalen

Vraag de feature related_persons op. Het antwoord bevat dan de sleutel related_persons met twee lijsten: current voor iedereen die vandaag zijn rol heeft, en past voor iedereen die is vertrokken. Elke rol is een eigen vermelding. In onze voorbeeldaanvraag voor Hetzner Online GmbH, Ansbach HRB 6089, bevatte current drie bestuurders. Twee van hen stonden ook in past met hun vroegere Prokura. Alle persoonsgegevens in de voorbeeldantwoorden zijn voorbeeldgegevens.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: JOUW_API_SLEUTEL" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=related_persons'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "JOUW_API_SLEUTEL"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["related_persons"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "related_persons");

const response = await fetch(url, {
  headers: { "x-api-key": "JOUW_API_SLEUTEL" },
});
const data = await response.json();

1{2  "name": "Hetzner Online GmbH",3  "related_persons": {4    "current": [5      {6        "entity_id": "ea3a1670232611a992727ed067216d07",7        "label": "MANAGING_DIRECTOR",8        "role": {9          "en": {10            "long": "Managing Director",11            "short": "MD"12          },13          "de": {14            "long": "Geschäftsführer",15            "short": "GF"16          }17        },18        "name": "Paul Musterwald",19        "start_date": "2019-01-04",20        "end_date": null,21        "birth_date": "1989-07-18",22        "name_parts": {23          "given": "Paul",24          "family": "Musterwald",25          "maiden": null,26          "canonical_name": "Musterwald, Paul",27          "previous_names": null28        },29        "location": {30          "home": {31            "city": "Exempelingen i. Bay."32          }33        },34        "organization_representation_scheme": {35          "current": [36            "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."37          ],38          "history": [39            {40              "value": [41                "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."42              ],43              "effective_from": "2002-10-15",44              "effective_to": "2015-07-28"45            },46            {47              "value": [48                "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."49              ],50              "effective_from": "2015-07-28",51              "effective_to": null52            }53          ]54        },55        "role_representation_scheme": {56          "current": [57            "einzelvertretungsberechtigt."58          ],59          "history": [60            {61              "value": [62                "einzelvertretungsberechtigt."63              ],64              "effective_from": "2019-01-04",65              "effective_to": null66            }67          ]68        }69      },70      {71        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72        "label": "MANAGING_DIRECTOR",73        "role": {74          "en": {75            "long": "Managing Director",76            "short": "MD"77          },78          "de": {79            "long": "Geschäftsführer",80            "short": "GF"81          }82        },83        "name": "Jan Musterhuber",84        "start_date": "2019-01-04",85        "end_date": null,86        "birth_date": "1955-11-06",87        "name_parts": {88          "given": "Jan",89          "family": "Musterhuber",90          "maiden": null,91          "canonical_name": "Musterhuber, Jan",92          "previous_names": null93        },94        "location": {95          "home": {96            "city": "Probeingen"97          }98        },99        "organization_representation_scheme": {100          "current": [101            "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."102          ],103          "history": [104            {105              "value": [106                "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."107              ],108              "effective_from": "2002-10-15",109              "effective_to": "2015-07-28"110            },111            {112              "value": [113                "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."114              ],115              "effective_from": "2015-07-28",116              "effective_to": null117            }118          ]119        },120        "role_representation_scheme": {121          "current": [122            "einzelvertretungsberechtigt."123          ],124          "history": [125            {126              "value": [127                "einzelvertretungsberechtigt."128              ],129              "effective_from": "2019-01-04",130              "effective_to": null131            }132          ]133        }134      },135      {136        "entity_id": "08ed5f967956831ca6588930fd2693ed",137        "label": "MANAGING_DIRECTOR",138        "role": {139          "en": {140            "long": "Managing Director",141            "short": "MD"142          },143          "de": {144            "long": "Geschäftsführer",145            "short": "GF"146          }147        },148        "name": "Max Felix Mustermann",149        "start_date": "2015-07-28",150        "end_date": null,151        "birth_date": "1976-01-15",152        "name_parts": {153          "given": "Max Felix",154          "family": "Mustermann",155          "maiden": null,156          "canonical_name": "Mustermann, Max Felix",157          "previous_names": null158        },159        "location": {160          "home": {161            "city": "Musterheim"162          }163        },164        "organization_representation_scheme": {165          "current": [166            "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."167          ],168          "history": [169            {170              "value": [171                "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."172              ],173              "effective_from": "2002-10-15",174              "effective_to": "2015-07-28"175            },176            {177              "value": [178                "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."179              ],180              "effective_from": "2015-07-28",181              "effective_to": null182            }183          ]184        },185        "role_representation_scheme": {186          "current": [187            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188          ],189          "history": [190            {191              "value": [192                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193              ],194              "effective_from": "2015-07-28",195              "effective_to": null196            }197          ]198        }199      }200    ],201    "past": [202      {203        "entity_id": "ea3a1670232611a992727ed067216d07",204        "label": "PROCURA",205        "role": {206          "en": {207            "long": "Procura",208            "short": "Procura"209          },210          "de": {211            "long": "Prokura",212            "short": "Prokura"213          }214        },215        "name": "Paul Musterwald",216        "start_date": "2015-07-28",217        "end_date": "2019-01-04",218        "birth_date": "1989-07-18",219        "name_parts": {220          "given": "Paul",221          "family": "Musterwald",222          "maiden": null,223          "canonical_name": "Musterwald, Paul",224          "previous_names": null225        },226        "location": {227          "home": {228            "city": "Exempelingen i. Bay."229          }230        },231        "organization_representation_scheme": {232          "latest": [233            "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."234          ],235          "history": [236            {237              "value": [238                "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."239              ],240              "effective_from": "2002-10-15",241              "effective_to": "2015-07-28"242            },243            {244              "value": [245                "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."246              ],247              "effective_from": "2015-07-28",248              "effective_to": null249            }250          ]251        },252        "role_representation_scheme": {253          "latest": [254            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255          ],256          "history": [257            {258              "value": [259                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260              ],261              "effective_from": "2015-07-28",262              "effective_to": "2019-01-04"263            }264          ]265        }266      },267      {268        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269        "label": "PROCURA",270        "role": {271          "en": {272            "long": "Procura",273            "short": "Procura"274          },275          "de": {276            "long": "Prokura",277            "short": "Prokura"278          }279        },280        "name": "Jan Musterhuber",281        "start_date": "2015-07-28",282        "end_date": "2019-01-04",283        "birth_date": "1955-11-06",284        "name_parts": {285          "given": "Jan",286          "family": "Musterhuber",287          "maiden": null,288          "canonical_name": "Musterhuber, Jan",289          "previous_names": null290        },291        "location": {292          "home": {293            "city": "Probeingen"294          }295        },296        "organization_representation_scheme": {297          "latest": [298            "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."299          ],300          "history": [301            {302              "value": [303                "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."304              ],305              "effective_from": "2002-10-15",306              "effective_to": "2015-07-28"307            },308            {309              "value": [310                "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."311              ],312              "effective_from": "2015-07-28",313              "effective_to": null314            }315          ]316        },317        "role_representation_scheme": {318          "latest": [319            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320          ],321          "history": [322            {323              "value": [324                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325              ],326              "effective_from": "2015-07-28",327              "effective_to": "2019-01-04"328            }329          ]330        }331      },332      {333        "entity_id": "08ed5f967956831ca6588930fd2693ed",334        "label": "BOARD",335        "role": {336          "en": {337            "long": "Board Member",338            "short": "Board"339          },340          "de": {341            "long": "Vorstandsmitglied",342            "short": "Vorstand"343          }344        },345        "name": "Max Felix Mustermann",346        "start_date": "2002-10-15",347        "end_date": "2015-07-28",348        "birth_date": "1976-01-15",349        "name_parts": {350          "given": "Max Felix",351          "family": "Mustermann",352          "maiden": null,353          "canonical_name": "Mustermann, Max Felix",354          "previous_names": null355        },356        "location": {357          "home": {358            "city": "Musterheim"359          }360        },361        "organization_representation_scheme": {362          "latest": [363            "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."364          ],365          "history": [366            {367              "value": [368                "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."369              ],370              "effective_from": "2002-10-15",371              "effective_to": "2015-07-28"372            },373            {374              "value": [375                "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."376              ],377              "effective_from": "2015-07-28",378              "effective_to": null379            }380          ]381        },382        "role_representation_scheme": {383          "latest": [384            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385          ],386          "history": [387            {388              "value": [389                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390              ],391              "effective_from": "2002-10-15",392              "effective_to": "2015-07-28"393            }394          ]395        }396      }397    ]398  }399}

200 · Voorbeeldantwoord: Hetzner Online GmbH met de feature related_persons, ingekort tot naam en personen

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
related_personsobject\|null	Alle ingeschreven personen van het bedrijf, verdeeld in current en past.`related_persons`	–	altijd
related_persons.currentarray	Personen die vandaag hun rol hebben.	–	zoals hierboven
related_persons.pastarray	Personen die zijn vertrokken, met dezelfde velden als current. In de twee vertegenwoordigingsregelingen vervangt latest het veld current: de laatste versie vóór het vertrek.Leeg als er sinds de inschrijving niemand is vertrokken	–	meestal

Velden van een persoon

Elke vermelding in current en past heeft dezelfde velden. Zonder Realtime heeft een persoon in alle bedrijfsprofielen en in het persoonsprofiel dezelfde entity_id. Zo herken je personen over bedrijven heen. Personen uit een Realtime-opvraging hebben eigen ID’s.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
related_persons.current[].entity_idstring\|null	ID van de persoon. Zonder Realtime is hij in alle bedrijfsprofielen gelijk en komt hij overeen met de entity_id in het persoonsprofiel.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	altijd
related_persons.current[].labelstring	Rol als vaste waarde. Andere waarden zijn mogelijk.Waarden: `MANAGING_DIRECTOR` bestuurder (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` noodbestuurder (Notgeschäftsführer), `BOARD` lid van de raad van bestuur (Vorstand), `BOARD_CHAIR` voorzitter van de raad van bestuur, `DIRECTOR` uitvoerend bestuurder, bijvoorbeeld van een SE, `PROCURA` procuratiehouder (Prokurist), `LIQUIDATOR` vereffenaar, `INSOLVENCY_ADMINISTRATOR` insolventiebewindvoerder, `REPRESENTATIVE` vaste vertegenwoordiger, `FULLY_LIABLE_PARTNER` beherend vennoot (persönlich haftender Gesellschafter), `LIMITED_PARTNER` commanditaire vennoot (Kommanditist), `PARTNER` partner, `OWNER` eigenaar (Inhaber), `PROPRIETOR` eigenaar (Inhaber), `TREASURER` penningmeester van een vereniging, `SECRETARY` secretaris van een vereniging, `YOUTH_WARDEN` jeugdwerker van een vereniging, `WATER_WARDEN` waterwacht van een vereniging, `OTHER` andere rol	`"MANAGING_DIRECTOR"`	zoals hierboven
related_persons.current[].roleobject	Rolnaam voor weergave, in de en en, telkens lang (long) en kort (short), bijvoorbeeld Geschäftsführer en GF.	–	zoals hierboven
related_persons.current[].namestring	Volledige naam zoals die in het register staat.	`"Paul Musterwald"`	zoals hierboven
related_persons.current[].name_partsobject	De naam opgesplitst in zijn delen, voor sorteren en matchen.	–	zoals hierboven
related_persons.current[].name_parts.givenstring\|null	Voornaam, alle voornamen als er meerdere zijn.	`"Paul"`	zoals hierboven
related_persons.current[].name_parts.familystring\|null	Achternaam.	`"Musterwald"`	zoals hierboven
related_persons.current[].name_parts.canonical_namestring\|null	De naam, meestal in de vorm „Achternaam, Voornaam”, voor sorteren en matchen.	`"Musterwald, Paul"`	zoals hierboven
related_persons.current[].name_parts.maidenstring\|null	Geboortenaam.Leeg als er geen is ingeschreven	`null`	zelden
related_persons.current[].name_parts.previous_namesarray\|null	Eerdere namen van de persoon als lijst.Leeg als er geen zijn ingeschreven	`null`	zoals hierboven
related_persons.current[].titlesarray	Academische titels, bijvoorbeeld Dr. De sleutel ontbreekt als er geen titel is ingeschreven.	–	zoals hierboven
related_persons.current[].birth_datestring\|null	Geboortedatum in het formaat YYYY-MM-DD, zoals ingeschreven.Leeg als er geen datum is ingeschreven	`"1989-07-18"`	meestal
related_persons.current[].locationobject\|null	Plaatsen van de persoon.	–	zoals hierboven
related_persons.current[].location.home.citystring\|null	Woonplaats, zoals ingeschreven. Het register bevat geen volledig adres.Leeg als er geen woonplaats is ingeschreven	`"Exempelingen i. Bay."`	zoals hierboven
related_persons.current[].start_datestring\|null	Begin van de rol in het formaat YYYY-MM-DD.Leeg als het begin niet bekend is, bijvoorbeeld bij Realtime	`"2019-01-04"`	zoals hierboven
related_persons.current[].end_datestring\|null	Einde van de rol. Is ingevuld bij personen in past.Leeg als de rol nog bestaat	`null`	altijd

Bestuurders en raad van bestuur

De bestuurders (Geschäftsführer) van een GmbH of UG hebben het label MANAGING_DIRECTOR. De raad van bestuur (Vorstand) van een AG, SE of eG herken je aan BOARD, de voorzitter aan BOARD_CHAIR. Wordt een bedrijf ontbonden, dan nemen vereffenaars met LIQUIDATOR de vertegenwoordiging over.

Controleer rollen altijd op label. De teksten in role zijn bedoeld voor weergave.

Prokura

Prokura is de ingeschreven volmacht (procuratie) om het bedrijf bij bijna alle zaken te vertegenwoordigen. Procuratiehouders (Prokuristen) hebben het label PROCURA. Of iemand alleen of alleen samen met anderen mag optreden, staat in role_representation_scheme, bijvoorbeeld „Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (gezamenlijke procuratie samen met een bestuurslid).

Beherend vennoten

Bij een KG, OHG en KGaA vertegenwoordigen de beherend vennoten (persönlich haftende Gesellschafter) het bedrijf. Ze hebben het label FULLY_LIABLE_PARTNER. Commanditaire vennoten (Kommanditisten) van een KG staan in het register met LIMITED_PARTNER, de eigenaar van een e.K. met OWNER, de partners van een PartG of eGbR met PARTNER.

Bij een GmbH & Co. KG is de beherend vennoot meestal zelf een GmbH. De bestuurders daarvan vind je in het bedrijfsprofiel van die GmbH.

Rollen per rechtsvorm

Welke rollen een bedrijf heeft, volgt uit zijn rechtsvorm. De tabel toont welke labels je per rechtsvorm meestal ziet. Alle labels met hun betekenis staan hierboven onder label.

Rechtsvorm
Rechtsvorm	Typische labels
GmbH, UG	MANAGING_DIRECTOR, PROCURA, in vereffening LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, bij een KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Vertegenwoordigingsbevoegdheid

Elke persoon komt met twee regelingen. role_representation_scheme is diens eigen bevoegdheid, bijvoorbeeld „einzelvertretungsberechtigt” (zelfstandig vertegenwoordigingsbevoegd). organization_representation_scheme is de algemene regeling van het bedrijf, dezelfde als representation_scheme in de basisgegevens. Beide hebben current en history; bij voormalige personen vervangt latest het veld current.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
related_persons.current[].role_representation_schemeobject	De eigen vertegenwoordigingsbevoegdheid van de persoon, bijvoorbeeld „einzelvertretungsberechtigt” (zelfstandig vertegenwoordigingsbevoegd) of een vrijstelling van § 181 BGB. current is de geldende versie, history de wijzigingen met value, effective_from en effective_to.`related_persons`	–	meestal: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG zelden: e.K.
related_persons.current[].organization_representation_schemeobject	De algemene vertegenwoordigingsregels van het bedrijf, bij elke persoon meegeleverd. Opgebouwd zoals role_representation_scheme.	–	altijd: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG meestal: AG, SE, KGaA, e.K.

Personen met Realtime

Met realtime_mode=handelsregister-default komen de op dat moment ingeschreven personen direct uit het Handelsregister, ook zonder de feature related_persons. Dan wordt alleen Realtime berekend, niet de feature. Het antwoord bevat alleen current.

In deze lijst zijn start_date en end_date leeg, namen kunnen korter zijn, en de entity_id van een persoon kan afwijken van die zonder Realtime. Match personen op naam en geboortedatum.

Vraag je Realtime en related_persons samen op, dan komt current uit de live-opvraging en past uit het bedrijfsprofiel. Dan wordt ook de feature berekend.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
related_persons.current[].name_parts.aliasesarray	Schrijfwijzen van de naam uit de live-opvraging, in de vorm „Achternaam, Voornaam”. Alleen met Realtime.`related_persons`	–	altijd

Persoonsprofiel

Het persoonsprofiel (fetch-person) beschrijft één persoon: diens rollen in alle bedrijven waarmee die verbonden is, en wat openbare webbronnen over die persoon zeggen. Je vindt de persoon op naam en een bedrijf waarin die een rol heeft of had.

Het persoonsprofiel zit in elk creditabonnement vanaf Plus. Een aanvraag duurt vaak tien tot dertig seconden, omdat we het web onderzoeken. Stel de timeout van je client in op minstens 120 seconden.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: JOUW_API_SLEUTEL" \
  --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": "JOUW_API_SLEUTEL"},
    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": "JOUW_API_SLEUTEL" },
});
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}

200 · Voorbeeldantwoord: persoonsprofiel van Max Felix Mustermann (voorbeeldgegevens) bij Hetzner Online GmbH, ingekort

De persoon

Naam, geboortedatum en woonplaats komen uit het register. De entity_id is dezelfde als in related_persons van de bedrijfsprofielen zonder Realtime.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
entity_idstring	ID van de persoon. Dezelfde ID staat in related_persons van de bedrijfsprofielen zonder Realtime.Persoonsprofiel	`"08ed5f967956831ca6588930fd2693ed"`	altijd
namestring	Volledige naam zoals die in het register staat.	`"Max Felix Mustermann"`	zoals hierboven
birth_datestring\|null	Geboortedatum in het formaat YYYY-MM-DD, zoals ingeschreven.Leeg als er geen datum is ingeschreven	`"1976-01-15"`	meestal
name_partsobject	De naam opgesplitst in zijn delen, opgebouwd zoals in related_persons.	–	altijd
name_parts.givenstring\|null	Voornaam, alle voornamen als er meerdere zijn.	`"Max Felix"`	zoals hierboven
name_parts.familystring\|null	Achternaam.	`"Mustermann"`	zoals hierboven
name_parts.canonical_namestring\|null	De naam, meestal in de vorm „Achternaam, Voornaam”, voor sorteren en matchen.	`"Mustermann, Max Felix"`	zoals hierboven
name_parts.maidenstring\|null	Geboortenaam.Leeg als er geen is ingeschreven	`null`	zelden
name_parts.previous_namesarray\|null	Eerdere namen van de persoon als lijst.Leeg als er geen zijn ingeschreven	`null`	zoals hierboven
locationobject	Plaatsen van de persoon.	–	meestal
location.home.citystring\|null	Woonplaats, zoals ingeschreven.Leeg als er geen woonplaats is ingeschreven	`"Musterheim"`	zoals hierboven

Rollen en verbindingen

handelsregister_roles bevat elke ingeschreven rol van de persoon met het bedrijf en de periode. Met de entity_id van een bedrijf haal je het bedrijfsprofiel op. affiliations vat de verbindingen kort samen, uit register en web.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
handelsregister_rolesarray	De ingeschreven rollen van de persoon met bedrijf en periode, huidig en voormalig.Persoonsprofiel	–	altijd
handelsregister_roles[].entity_idstring	entity_id van het bedrijf, voor een bedrijfsprofiel in de parameter q.	`"0b3435f83ce8591300625100815d4583"`	zoals hierboven
handelsregister_roles[].namestring	Naam van het bedrijf.	`"Hetzner Online GmbH"`	zoals hierboven
handelsregister_roles[].labelstring	Rol als vaste waarde, dezelfde waarden als label in related_persons, bijvoorbeeld MANAGING_DIRECTOR, BOARD, PROCURA of LIMITED_PARTNER.	`"BOARD"`	zoals hierboven
handelsregister_roles[].roleobject	Rolnaam voor weergave, als tekst in de en en.	–	zoals hierboven
handelsregister_roles[].start_datestring\|null	Begin van de rol in het formaat YYYY-MM-DD.Leeg als het begin niet bekend is	`"2002-10-15"`	meestal
handelsregister_roles[].end_datestring\|null	Einde van de rol.Leeg als de rol nog bestaat	`"2015-07-28"`	altijd
affiliationsarray	De bedrijven waarmee de persoon verbonden is, elk met het soort verbinding. Samengevat uit register- en webbronnen.	–	zoals hierboven
affiliations[].organizationstring	Naam van het bedrijf.	`"ENSoXX Holding AG"`	zoals hierboven
affiliations[].relationstring	Soort verbinding als Duitse tekst, bijvoorbeeld Geschäftsführer (bestuurder), Prokura of Kommanditist (commanditaire vennoot).	`"Vorstandsmitglied"`	zoals hierboven

Webonderzoek

De korte bio, vakgebieden, contactkanalen en bronnen verzamelen we uit openbare webbronnen. Hoeveel daarvan er is, hangt af van hoe zichtbaar de persoon op het web is.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
biostring\|null	Korte bio van de persoon in een of twee zinnen, in het Duits.Leeg als het web te weinig over de persoon bevat (dan null)Persoonsprofiel	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	meestal
expertisearray	Vakgebieden en onderwerpen van de persoon als lijst.Leeg als het web te weinig over de persoon bevat	–	zoals hierboven
contactobject	Openbaar vermelde contactkanalen, met emails en phones.	–	altijd
contact.emailsarray	E-mailadressen als lijst.Leeg als er geen adres is gevonden	–	zelden
contact.emails[].addressstring	Het e-mailadres.	`"[email protected]"`	zoals hierboven
contact.emails[].typestring	Soort adres. organization betekent: een adres van het bedrijf, geen privéadres.	`"organization"`	zoals hierboven
contact.emails[].labelstring	Waarvoor het adres dient, als korte tekst.	`"Allgemeine Unternehmenskontakt-E-Mail"`	zoals hierboven
contact.phonesarray	Telefoonnummers als lijst.Leeg als er geen nummer is gevonden	–	zoals hierboven
contact.phones[].numberstring	Het nummer, meestal in internationaal formaat.	`"+49374574447100"`	zoals hierboven
contact.phones[].typestring	Soort nummer. organization betekent: een nummer van het bedrijf.	`"organization"`	zoals hierboven
contact.phones[].entitystring	Het bedrijf waar het nummer bij hoort.	`"Hetzner Online GmbH"`	zoals hierboven
contact.phones[].labelstring	Waarvoor het nummer dient, bijvoorbeeld centrale of fax.	`"Öffentliche Unternehmens-Telefonnummer"`	zoals hierboven
profilesobject	Webpagina’s over de persoon, met linkedin en other.	–	altijd
profiles.linkedinstring\|null	Adres van het LinkedIn-profiel.Leeg als er geen is gevonden	`null`	zelden
profiles.otherarray	Andere pagina’s over de persoon, bijvoorbeeld persartikelen of teampagina’s, als lijst van adressen.Leeg als er geen zijn gevonden	–	meestal

Een AI stelt deze informatie samen uit openbare bronnen. We gebruiken daarvoor de nieuwste technologie en investeren veel in kwaliteit; afzonderlijke fouten blijven mogelijk.

Deelnemingen en netwerk

Twee features breiden het persoonsprofiel uit: shareholdings toont de bedrijven waarin de persoon deelneemt. network toont de bedrijven en personen waarmee die verbonden is, over twee niveaus. Beide worden alleen berekend als ze gegevens opleveren.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholdingsobject\|null	Bedrijven waarin de persoon vandaag deelneemt.Leeg als er geen deelneming bekend is`shareholdings`	–	deels
shareholdings.holdings.currentarray	De huidige deelnemingen als lijst.	–	zoals hierboven
shareholdings.holdings.current[].organizationobject	Het bedrijf met entity_id, name, status, legal_form, address en registration, opgebouwd zoals in de basisgegevens.	–	zoals hierboven
shareholdings.holdings.current[].ownership.percentagenumber\|null	Aandeel in het kapitaal in procent, bijvoorbeeld 33.33.	`100`	zoals hierboven
shareholdings.holdings.current[].ownership.contributionobject\|null	Nominaal bedrag van de deelneming met amount en currency.	–	zoals hierboven
shareholdings.holdings.current[].as_ofstring\|null	Datum van de informatie in het formaat YYYY-MM-DD.	`"2025-01-13"`	zoals hierboven
shareholdings.summary.total_currentinteger	Aantal huidige deelnemingen.	`3`	zoals hierboven
networkobject\|null	Bedrijven en personen waarmee de persoon verbonden is, over twee niveaus. Opgebouwd zoals network in het bedrijfsprofiel.`network` · vanaf Pro · Bèta	–	meestal
network.depthinteger	Hoeveel niveaus het netwerk omvat, gerekend vanaf de persoon. De persoon zelf is niveau 0.	`2`	zoals hierboven
network.nodesarray	De knooppunten: personen (PERSON) en bedrijven (ORGANIZATION) met entity_id, naam en hun niveau. De persoon zelf heeft is_root true.	–	zoals hierboven
network.connectionsarray	De verbindingen tussen twee knooppunten, elk met kind (ROLE, OWNERSHIP of GROUP), label, periode en is_current.	–	zoals hierboven

Verder

fetch-organization Het endpoint met de feature related_persons en Realtime. fetch-person Het persoonsprofiel ophalen: parameters, kosten en fouten. Bestuurders en aandeelhouders vinden Stap voor stap van het bedrijf naar zijn personen. Aandeelhouders en deelnemingen Wie een bedrijf bezit en waarin het deelneemt.