Aandeelhouders en deelnemingen – Documentatie

Feature
Feature	Wat ze levert	Credits	Beschikbaar
shareholders	Aandeelhouders: de huidige aandeelhouders met hun aandelen en eerdere aandeelhouderslijsten	5	elk account · Bèta
shareholders_deep	Diepgaande aandeelhoudersgegevens: houders met aandeelnummers, sinds wanneer ze aandelen houden en wat er laatst is veranderd	80	Max
ubos	Uiteindelijk belanghebbenden (UBO): de personen achter het bedrijf, berekend uit de aandeelhouderslijsten	10	elk account · Bèta
shareholdings	Deelnemingen: bedrijven waarin het bedrijf zelf aandelen houdt	5	elk account · Bèta

Aandeelhouders per rechtsvorm

Wat het register over de eigenaren zegt, hangt af van de rechtsvorm. De tabel toont wat je meestal krijgt.

Rechtsvorm
Rechtsvorm	Aandeelhouders in het antwoord
GmbH, UG	Alle aandeelhouders uit de aandeelhouderslijst volgens § 40 GmbHG, met nominaal bedrag en aandeel in het maatschappelijk kapitaal (Stammkapital), plus eerdere lijsten.
AG, SE, KGaA	Alleen in afzonderlijke gevallen, omdat aandeelhouders van een AG in geen enkel openbaar register staan.
GmbH & Co. KG	De commanditaire vennoten (Kommanditisten) uit het register met hun aansprakelijkheidsbedrag, deels ook de beherend vennoot-GmbH.
KG, OHG	De ingeschreven vennoten: bij een KG de beherend vennoten (Komplementäre) en commanditaire vennoten, bij een OHG de vennoten met persoonlijke aansprakelijkheid.
e.K.	De eigenaar.
eG	Geen. De ledenlijst van een coöperatie is niet openbaar.
PartG	De ingeschreven partners.

Aandeelhouderslijsten zijn vaak gescande documenten in veel opmaken. We halen ze automatisch uit. We gebruiken daarvoor de nieuwste technologie en investeren veel in kwaliteit; afzonderlijke fouten blijven mogelijk.

Aandeelhouders

De feature shareholders levert de huidige aandeelhouders: bij een GmbH uit de nieuwste aandeelhouderslijst, bij personenvennootschappen en eenmanszaken uit het register. Ze kost 5 credits, maar alleen als ze huidige aandeelhouders noemt. Levert ze alleen eerdere lijsten, dan kost ze niets.

Elke vermelding in entries beschrijft een persoon of een bedrijf. Een persoon heeft first_name, last_name en birth_date, een bedrijf entity_name, country_code en registration_reference.

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=shareholders'

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": ["shareholders"],
    },
)
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", "shareholders");

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

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholdersobject\|null	De aandeelhouders van het bedrijf: huidige stand in entries, eerdere standen in history.Leeg als er geen aandeelhouders bekend zijn, bijvoorbeeld bij een AG of eG`shareholders` · Bèta	–	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders.entriesarray	De huidige aandeelhouders, één vermelding per persoon of bedrijf.	–	zoals hierboven
shareholders.entries[].shareholderobject	Wie het aandeel houdt: een persoon of een bedrijf, met de velden hieronder.	–	zoals hierboven
shareholders.entries[].shareholder.entity_idstring\|null	ID van de persoon of het bedrijf, voor het eigen persoonsprofiel of bedrijfsprofiel.Leeg als de aandeelhouder niet met zekerheid kon worden gekoppeld	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	zoals hierboven
shareholders.entries[].shareholder.first_namestring	Voornaam van een persoon, met alle ingeschreven voornamen.	–	altijd: e.K. meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG zelden: AG, SE, KGaA nooit: eG
shareholders.entries[].shareholder.last_namestring	Achternaam van een persoon.	–	zoals hierboven
shareholders.entries[].shareholder.birth_datestring\|null	Geboortedatum van een persoon, in het formaat YYYY-MM-DD.Leeg als het document geen geboortedatum geeft	–	zoals hierboven
shareholders.entries[].shareholder.entity_namestring	Naam van een bedrijf dat aandeelhouder is.	`"ENSoXX GmbH"`	meestal: GmbH, UG, GmbH & Co. KG zelden: AG, SE, KGaA, KG, OHG nooit: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Land van een bedrijf als drieletterige ISO-code (ISO 3166-1 alpha-3), bijvoorbeeld DEU.	`"DEU"`	zoals hierboven
shareholders.entries[].shareholder.registration_referencestring\|null	Registerinschrijving van een bedrijf als tekst, zoals die in het document staat.Leeg als het document geen registerinschrijving geeft, vaak bij buitenlandse bedrijven	`"AG Ansbach HRB 6105"`	zoals hierboven
shareholders.entries[].shareholder.addressstring\|null	Adres, woonplaats of zetel als tekst, zoals die in het document staat.Leeg als het document geen adres geeft	`"Gunzenhausen"`	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders.entries[].contributionobject\|null	Het bedrag van de deelneming met amount en currency: bij een GmbH het nominale bedrag van de aandelen, bij commanditaire vennoten het ingeschreven aansprakelijkheidsbedrag (Haftsumme).Leeg als er geen bedrag is ingeschreven, bijvoorbeeld bij vennoten met persoonlijke aansprakelijkheid of de eigenaar van een e.K	–	meestal: GmbH, UG, GmbH & Co. KG deels: KG, OHG zelden: AG, SE, KGaA nooit: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Aandeel in het kapitaal als decimaal getal: 1 betekent 100 %, 0.245 betekent 24,5 %.Leeg als er geen aandeel kan worden afgeleid, bijvoorbeeld bij personenvennootschappen	`0.945`	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders.entries[].roleobject	De rol: label als vaste code, plus de en en met een lange en een korte naam, bijvoorbeeld Kommanditist en Kom.	–	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders.entries[].role.labelstring	De rol als vaste code. Er kunnen nieuwe waarden bijkomen.Waarden: `SHAREHOLDER` aandeelhouder volgens de aandeelhouderslijst, `LIMITED_PARTNER` commanditaire vennoot (Kommanditist), `FULLY_LIABLE_PARTNER` vennoot met persoonlijke aansprakelijkheid (persönlich haftender Gesellschafter), `PARTNER` partner van een PartG, `OWNER` eigenaar van een e.K.	`"SHAREHOLDER"`	zoals hierboven
shareholders.total_capitalobject\|null	Het kapitaal volgens de aandeelhouderslijst, met amount en currency, de basis voor contribution_ratio.Leeg als de lijst geen kapitaal geeft, en bij personenvennootschappen	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG

Met de entity_id van een aandeelhouder haal je diens eigen bedrijfsprofiel of persoonsprofiel op. Zo volg je een eigendomsketen niveau voor niveau.

Aandeelhoudershistorie

shareholders.history komt zonder extra kosten. Het bevat de datum van de huidige lijst en de eerdere aandeelhouderslijsten, nieuwste eerst.

Bij een KG of GmbH & Co. KG staan voormalige vennoten in register_ownership, met datum van toe- en uittreding uit het register. Bij OHG, PartG en e.K. vind je ze in shareholders_deep.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholders.historyobject	Eerdere standen van de aandeelhouders, zonder extra kosten.Leeg als er geen eerdere standen zijn; het veld ontbreekt dan, bijvoorbeeld bij OHG, PartG of e.K`shareholders` · Bèta	–	meestal: GmbH, UG deels: GmbH & Co. KG, KG, OHG zelden: AG, SE, KGaA nooit: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Datum van de aandeelhouderslijst waar entries vandaan komt.Leeg als de aandeelhouders uit het register komen	`"2015-08-21"`	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders.history.pastarray	Eerdere aandeelhouderslijsten, nieuwste eerst.Leeg als er maar één lijst is	–	zoals hierboven
shareholders.history.past[].as_ofstring	Datum van deze aandeelhouderslijst.	`"2015-07-28"`	zoals hierboven
shareholders.history.past[].data.total_capitalobject\|null	Het kapitaal volgens deze lijst, met amount en currency. Oudere lijsten geven het deels in DEM.	–	zoals hierboven
shareholders.history.past[].data.shareholdersarray	De aandeelhouders volgens deze lijst, met dezelfde velden als entries.	–	zoals hierboven
shareholders.history.register_ownershipobject	Bij KG en GmbH & Co. KG: voormalige vennoten volgens het register, in past.	–	deels: GmbH & Co. KG, KG, OHG nooit: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	De voormalige vennoot, met dezelfde velden als in entries.	–	zoals hierboven
shareholders.history.register_ownership.past[].roleobject	Diens rol, opgebouwd zoals role in entries.	–	zoals hierboven
shareholders.history.register_ownership.past[].effective_fromstring\|null	Sinds wanneer die was ingeschreven, in het formaat YYYY-MM-DD.	`"2022-01-07"`	zoals hierboven
shareholders.history.register_ownership.past[].effective_tostring\|null	Tot wanneer die was ingeschreven.	`"2026-07-06"`	zoals hierboven
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true als effective_to is afgeleid en niet expliciet ingeschreven.	`false`	zoals hierboven
shareholders.history.register_ownership.past[].contributionnull	Hier altijd null.	–	zoals hierboven
shareholders.history.register_ownership.past[].contribution_rationull	Hier altijd null.	–	zoals hierboven

Diepgaande aandeelhoudersgegevens

De feature shareholders_deep zit in het plan Max. Ze kost 80 credits, maar alleen als het huidige document ten minste één houder noemt.

Ze leest alle aandeelhouderslijsten van een bedrijf, niet alleen de nieuwste. Zo toont ze sinds wanneer iemand aandelen houdt, hoe de eerdere standen eruitzagen en wat de laatste lijst heeft veranderd.

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=shareholders_deep'

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": ["shareholders_deep"],
    },
)
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", "shareholders_deep");

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

Het document. record zegt waar de huidige stand vandaan komt, share_capital geeft het kapitaal volgens dat document.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholders_deepobject\|null	Houders, aandelen, eerdere documenten en de laatste wijziging.Leeg als er geen huidig document en geen ingeschreven vennoot bekend is, typisch voor AG, SE en eG`shareholders_deep` · vanaf Max	–	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.recordobject	Het document waar de huidige stand vandaan komt: datum en bron.	–	zoals hierboven
shareholders_deep.record.datestring\|null	De datum waar het document naar verwijst. Die ligt meestal kort na de wijziging die het document toont.Leeg als de aandeelhouders uit het register komen (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.record.sourcestring	Het soort document.Waarden: `SHAREHOLDER_LIST` aandeelhouderslijst (Gesellschafterliste), `FOUNDING_DOCUMENT` oprichtingsdocument, dus Musterprotokoll (modelprotocol) of Gesellschaftsvertrag (statuten), `COMMERCIAL_REGISTER` vennoten of eigenaren die in het register zijn ingeschreven	`"SHAREHOLDER_LIST"`	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.share_capitalobject\|null	Het kapitaal volgens het document: value, currency en basis.Leeg als het document geen kapitaal geeft, en altijd bij COMMERCIAL_REGISTER	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Waar het bedrag vandaan komt.Waarden: `REPORTED` vermeld in het document, `CALCULATED` berekend uit het aantal en het nominale bedrag van de aandelen	`"REPORTED"`	zoals hierboven

De houders. Elke vermelding in entries is één regel van het document, het grootste aandeel eerst. Heeft iemand meerdere regels, dan staat die meerdere keren in de lijst.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholders_deep.entriesarray	De huidige houders, één regel van het document per vermelding, het grootste aandeel eerst.`shareholders_deep` · vanaf Max	–	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.entries[].holderobject	Wie het aandeel houdt. type bepaalt welke velden volgen.	–	zoals hierboven
shareholders_deep.entries[].holder.typestring	Het soort houder.Waarden: `ORGANIZATION` bedrijf of andere organisatie, `PERSON` natuurlijke persoon, `JOINT` gezamenlijk gehouden aandeel, bijvoorbeeld van een erfgemeenschap, met members	`"ORGANIZATION"`	zoals hierboven
shareholders_deep.entries[].holder.entity_idstring\|null	ID van de houder, voor het eigen bedrijfsprofiel of persoonsprofiel.Leeg als de houder niet met zekerheid kon worden gekoppeld, en altijd bij JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	zoals hierboven
shareholders_deep.entries[].holder.namestring	De naam. Bij gekoppelde houders de huidige naam, anders zoals in het document.	`"ENSoXX GmbH"`	zoals hierboven
shareholders_deep.entries[].holder.birth_datestring\|null	Alleen bij personen: de geboortedatum.Leeg als het document er geen geeft	–	altijd: e.K. meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Alleen bij organisaties: de rechtsvorm als tekst, bijvoorbeeld GmbH of Ltd.	`"GmbH"`	meestal: GmbH, UG, GmbH & Co. KG zelden: AG, SE, KGaA, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Alleen bij organisaties: de huidige status in het register.Leeg als de houder niet is gekoppeld, en altijd in de eerdere documenten in historyWaarden: `ACTIVE` actief, `INACTIVE` niet meer actief, bijvoorbeeld uitgeschreven of gefuseerd	`"ACTIVE"`	zoals hierboven
shareholders_deep.entries[].holder.citystring\|null	Zetel of woonplaats.	`"Gunzenhausen"`	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.entries[].holder.countrystring\|null	Land als drieletterige ISO-code (ISO 3166-1 alpha-3), bijvoorbeeld DEU, AUT of LUX.	`"DEU"`	zoals hierboven
shareholders_deep.entries[].holder.registrationobject\|null	Alleen bij organisaties: court, register_type en register_number.Leeg als er geen registerinschrijving kan worden gelezen, bijvoorbeeld bij veel buitenlandse bedrijven	–	meestal: GmbH, UG, GmbH & Co. KG zelden: AG, SE, KGaA, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Alleen bij organisaties: de registerinschrijving als tekst, als registration ontbreekt of geen rechtbank noemt.	`null`	zelden
shareholders_deep.entries[].rolestring	De rol van de houder. Er kunnen nieuwe waarden bijkomen.Waarden: `SHAREHOLDER` aandeelhouder volgens de aandeelhouderslijst of het oprichtingsdocument, `LIMITED_PARTNER` commanditaire vennoot (Kommanditist), `FULLY_LIABLE_PARTNER` vennoot met persoonlijke aansprakelijkheid (persönlich haftender Gesellschafter), `PARTNER` partner van een PartG, `OWNER` eigenaar van een e.K.	`"SHAREHOLDER"`	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.entries[].sincestring\|null	Sinds wanneer de houder aandelen houdt. Bij ingeschreven vennoten de datum van inschrijving.Leeg als er geen datum kan worden bepaald, en altijd bij JOINT	`"2015-08-18"`	zoals hierboven
shareholders_deep.entries[].since_basisstring\|null	Hoe zeker since is.Waarden: `ENTRY_RECORDED` vanaf deze datum gedocumenteerd: de lijst daarvoor noemt de houder nog niet, `EARLIEST_RECORD` al in het oudste beschikbare document, dus aandeelhouder sinds ten minste deze datum	`"ENTRY_RECORDED"`	zoals hierboven

Het aandeel. ownership beschrijft hoeveel een houder heeft: in procent, als nominaal bedrag en aan de hand van de volgnummers van de aandelen.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholders_deep.entries[].ownershipobject	Het aandeel van de houder.`shareholders_deep` · vanaf Max	–	meestal: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zelden: AG, SE, KGaA nooit: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Aandeel in het kapitaal in procent, van 0 tot 100. Dit is de directe deelneming, niet de stemrechten.Leeg als het aandeel niet betrouwbaar kan worden bepaald, en altijd bij ingeschreven vennoten van personenvennootschappen	`94.5`	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Waar percentage vandaan komt.Waarden: `REPORTED` vermeld in het document of afgeleid uit nominaal bedrag en kapitaal in het document, `CALCULATED` berekend uit het aantal en het nominale bedrag van de aandelen	`"REPORTED"`	zoals hierboven
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Som van de nominale bedragen met value en currency. Bij commanditaire vennoten het ingeschreven aansprakelijkheidsbedrag (Haftsumme).Leeg als er geen bedrag bekend is	–	meestal: GmbH, UG, GmbH & Co. KG deels: KG, OHG zelden: AG, SE, KGaA nooit: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Aantal aandelen (Geschäftsanteile).Leeg als het aantal niet voor alle aandelen bekend is	`47250`	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	De aandelen aan de hand van hun volgnummers in de lijst, één reeks per opeenvolging van gelijke aandelen.	–	zoals hierboven
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Eerste volgnummer van de reeks.	`1`	zoals hierboven
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Laatste volgnummer van de reeks.	`47250`	zoals hierboven
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Aantal aandelen in de reeks.	`47250`	zoals hierboven
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Nominaal bedrag per aandeel in de reeks, met value en currency.	–	zoals hierboven

Historie en wijzigingen. history bevat de eerdere documenten met dezelfde velden. De houders staan daar zoals ze destijds in het document stonden. changes vergelijkt de huidige stand met de vorige.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholders_deep.historyarray	De eerdere documenten, nieuwste eerst, elk met record, share_capital en entries. Voormalige ingeschreven vennoten staan verzameld in de laatste vermelding.`shareholders_deep` · vanaf Max	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	Bij JOINT: de gezamenlijke houders van het type PERSON of ORGANIZATION, met dezelfde velden als holder.	–	zelden
shareholders_deep.history[].entries[].untilstring\|null	Alleen in het item van history met COMMERCIAL_REGISTER: wanneer de vennoot is vertrokken.	–	deels: GmbH & Co. KG, KG, OHG, PartG zelden: e.K. nooit: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Wat er met het huidige document ten opzichte van het vorige is veranderd.Leeg als er geen eerder document is, en als de huidige stand uit het register of een oprichtingsdocument komt	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Datum van het vorige document.	`"2015-07-16"`	zoals hierboven
shareholders_deep.changes.joinedarray	Nieuwe houders: holder met entity_id, type en name, plus percentage.	–	zoals hierboven
shareholders_deep.changes.leftarray	Vertrokken houders, met het aandeel dat ze het laatst hadden.	–	zoals hierboven
shareholders_deep.changes.changedarray	Houders van wie het aandeel is veranderd.	–	zoals hierboven
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Aandeel in procent in het vorige document.	`100`	zoals hierboven
shareholders_deep.changes.changed[].percentage_afternumber\|null	Aandeel in procent in het huidige document.	`5.5`	zoals hierboven

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}

200 · Voorbeeldantwoord: Hetzner Online GmbH met de feature shareholders_deep

Ten opzichte van shareholders voegt shareholders_deep de aandeelnummers toe, de datum sinds wanneer iemand aandelen houdt, de wijzigingen en gezamenlijk gehouden aandelen met hun leden. Voor vergelijkingen over bedrijven en jaren heen gebruik je het best overal dezelfde feature.

Uiteindelijk belanghebbenden

Uiteindelijk belanghebbenden zijn de natuurlijke personen die een bedrijf uiteindelijk bezitten. De feature ubos volgt de aandeelhouderslijsten over de eigendomsniveaus heen tot aan de personen. De lijst noemt elke persoon met een berekend aandeel, zonder minimumdrempel. Ze kost 10 credits als ze gegevens oplevert.

Kan een aandeel niet tot een persoon worden herleid, dan staat het met de reden in unresolved_beneficial_owners. Vaak houdt een bedrijf in het buitenland het. Onze gegevens dekken Duitse bedrijven, dus de aandeelhouders van een bedrijf in het buitenland kennen we niet. coverage toont welk percentage van het kapitaal tot personen is herleid en hoeveel open blijft. De twee waarden komen niet altijd op 100. Voor de rest noemen de aandeelhoudersgegevens geen houder.

De feature wordt berekend zodra ze een resultaat levert. Dat geldt ook als alle aandelen in unresolved_beneficial_owners staan.

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=ubos'

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": ["ubos"],
    },
)
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", "ubos");

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

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
ubosobject\|null	De uiteindelijk belanghebbenden, berekend uit de aandeelhouderslijsten over de eigendomsniveaus heen.Leeg als er uit aandeelhouderslijsten geen keten kan worden opgebouwd, bijvoorbeeld bij AG, eG of e.K`ubos` · Bèta	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
ubos.beneficial_ownersarray	De personen die het bedrijf direct of via andere bedrijven bezitten.Leeg als er geen aandeel tot een persoon kan worden herleid	–	zoals hierboven
ubos.beneficial_owners[].personobject	De persoon, met de velden hieronder.	–	deels: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID van de persoon, voor het persoonsprofiel.Leeg als de persoon niet met zekerheid kon worden gekoppeld	–	zoals hierboven
ubos.beneficial_owners[].person.namestring	Volledige naam.	–	zoals hierboven
ubos.beneficial_owners[].person.name_partsobject	De naam in delen: given en family, en canonical_name als die bekend is.	–	zoals hierboven
ubos.beneficial_owners[].person.birth_datestring\|null	Geboortedatum.	–	zoals hierboven
ubos.beneficial_owners[].person.locationobject\|null	Woonplaats in home: city, county, state en country.Leeg als er geen woonplaats bekend is	–	zoals hierboven
ubos.beneficial_owners[].ownership_percentagenumber	Totaal aandeel van de persoon in procent, opgeteld over alle paden.	`50`	zoals hierboven
ubos.beneficial_owners[].pathsarray	Elk pad naar de persoon, met het aandeel langs dat pad.	–	zoals hierboven
ubos.beneficial_owners[].paths[].percentagenumber	Aandeel in procent dat via dit pad aankomt.	`50`	zoals hierboven
ubos.beneficial_owners[].paths[].viaarray	De bedrijven op dit pad, eerst de directe aandeelhouder van het gevraagde bedrijf (depth 1). De velden zijn dezelfde als in via van de onopgeloste aandelen.Leeg als de persoon direct aandelen houdt	–	zoals hierboven

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
ubos.unresolved_beneficial_ownersarray	Aandelen die niet tot een persoon konden worden herleid.Leeg als alle aandelen zijn opgelost`ubos` · Bèta	–	meestal: GmbH, UG zelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nooit: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Waarom de keten hier eindigt. Er kunnen nieuwe waarden bijkomen.Waarden: `unlinked` de aandeelhouder is een bedrijf dat we niet aan een inschrijving in het Duitse register kunnen koppelen, meestal een bedrijf in het buitenland. Zijn aandeelhouders kennen we niet, dus de keten eindigt hier, `no_further_shareholder_data` de aandeelhouder is een Duits bedrijf dat we kennen, maar er bestaat geen aandeelhouderslijst voor, bijvoorbeeld een KG, `cycle` de keten leidt terug naar een bedrijf dat er al in voorkomt, bijvoorbeeld als een bedrijf eigen aandelen houdt, `unknown` over de aandeelhouder is niets bekend, naam noch aandeel	`"cycle"`	zoals hierboven
ubos.unresolved_beneficial_owners[].namestring\|null	Naam van de aandeelhouder waar de keten eindigt.Leeg als de reden unknown is	`"ENSoXX Holding AG"`	zoals hierboven
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Diens ID, voor het eigen bedrijfsprofiel.Leeg als de aandeelhouder niet aan een bedrijf in onze gegevens is gekoppeld, dus bij de redenen unlinked en unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	zoals hierboven
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Diens rechtsvorm.	`"AG"`	zoals hierboven
ubos.unresolved_beneficial_owners[].addressobject\|array	Diens adres met street, house_number, postal_code, city, county, state, country en coordinates.Leeg als er geen adres bekend is; de waarde is dan een lege lijst []	–	zoals hierboven
ubos.unresolved_beneficial_owners[].registrationobject\|array	Diens registerinschrijving met court, register_type en register_number, ook uit buitenlandse registers.Leeg als er geen inschrijving bekend is; de waarde is dan een lege lijst []	–	zoals hierboven
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Het onopgeloste aandeel in procent, doorgerekend tot het gevraagde bedrijf. Het kan 0 zijn.	`0`	zoals hierboven
ubos.unresolved_beneficial_owners[].viaarray	De bedrijven waar de keten tot hier doorheen loopt, eerst de directe aandeelhouder van het gevraagde bedrijf.Leeg als het onopgeloste aandeel direct in het gevraagde bedrijf wordt gehouden	–	zoals hierboven
ubos.unresolved_beneficial_owners[].via[].depthinteger	Het niveau: 1 is een directe aandeelhouder van het gevraagde bedrijf. Daarnaast staan naam en entity_id van het bedrijf.	`1`	zoals hierboven
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Aandeel in procent op dit niveau.	`94.5`	zoals hierboven
ubos.coverageobject	Hoeveel van het kapitaal tot personen is herleid en hoeveel open blijft. De twee waarden komen niet altijd op 100.	–	zoals hierboven
ubos.coverage.resolved_percentagenumber	Tot personen herleid, in procent.	`5.5`	zoals hierboven
ubos.coverage.unresolved_percentagenumber	Niet tot personen herleid, in procent.	`0`	zoals hierboven

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "ubos": {5    "beneficial_owners": [6      {7        "person": {8          "entity_id": "08ed5f967956831ca6588930fd2693ed",9          "name": "Max Felix Mustermann",10          "birth_date": "1976-01-15",11          "name_parts": {12            "given": "Max Felix",13            "family": "Mustermann",14            "canonical_name": "Mustermann, Max Felix"15          },16          "location": {17            "home": {18              "city": "Musterheim",19              "county": "Musterheim (Landkreis)",20              "state": "Bayern",21              "country": "DEU"22            }23          }24        },25        "ownership_percentage": 5.5,26        "paths": [27          {28            "percentage": 5.5,29            "via": []30          }31        ]32      }33    ],34    "unresolved_beneficial_owners": [35      {36        "reason": "cycle",37        "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",38        "name": "ENSoXX Holding AG",39        "legal_form": "AG",40        "address": {41          "house_number": "25",42          "street": "Industriestraße",43          "postal_code": "91710",44          "city": "Gunzenhausen",45          "county": "Weißenburg-Gunzenhausen",46          "state": "Bayern",47          "country": "DEU",48          "coordinates": {49            "latitude": 49.12483,50            "longitude": 10.7805251          }52        },53        "registration": {54          "court": "Ansbach",55          "register_type": "HRB",56          "register_number": "6211"57        },58        "ownership_percentage": 0,59        "via": [60          {61            "depth": 1,62            "name": "ENSoXX GmbH",63            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",64            "step_percentage": 94.565          },66          {67            "depth": 2,68            "name": "ENSoXX Holding AG",69            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",70            "step_percentage": 10071          }72        ]73      },74      {75        "reason": "unknown",76        "entity_id": null,77        "name": null,78        "legal_form": null,79        "address": [],80        "registration": [],81        "ownership_percentage": 0,82        "via": [83          {84            "depth": 1,85            "name": "ENSoXX GmbH",86            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",87            "step_percentage": 94.588          },89          {90            "depth": 2,91            "name": "ENSoXX Holding AG",92            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",93            "step_percentage": 10094          }95        ]96      },97      {98        "reason": "unknown",99        "entity_id": null,100        "name": null,101        "legal_form": null,102        "address": [],103        "registration": [],104        "ownership_percentage": 0,105        "via": [106          {107            "depth": 1,108            "name": "ENSoXX GmbH",109            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",110            "step_percentage": 94.5111          },112          {113            "depth": 2,114            "name": "ENSoXX Holding AG",115            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",116            "step_percentage": 100117          }118        ]119      }120    ],121    "coverage": {122      "resolved_percentage": 5.5,123      "unresolved_percentage": 0124    }125  }126}

200 · Voorbeeldantwoord: Hetzner Online GmbH met de feature ubos. In onze voorbeeldaanvraag stond één persoon met 5,5% in beneficial_owners. De keten via ENSoXX GmbH, Ansbach HRB 6105, eindigde in unresolved_beneficial_owners met de redenen cycle en unknown.

De gegevens berekenen we uit de aandeelhouderslijsten. Gegevens over uiteindelijk belanghebbenden uit het Transparenzregister (UBO-register) zijn sinds eind 2022 niet meer openbaar toegankelijk.

Deelnemingen

De feature shareholdings toont de andere richting: in welke bedrijven het gevraagde bedrijf aandelen houdt. De deelnemingen komen uit de aandeelhouderslijsten van die bedrijven. Ze kost 5 credits als er deelnemingen zijn.

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=shareholdings'

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": ["shareholdings"],
    },
)
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", "shareholdings");

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

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
shareholdingsobject\|null	De bedrijven waarin het gevraagde bedrijf aandelen houdt.Leeg als er geen deelneming bekend is`shareholdings` · Bèta	–	meestal: AG, SE, KGaA deels: GmbH, UG zelden: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	De huidige deelnemingen, één per bedrijf.	–	zoals hierboven
shareholdings.holdings.current[].organizationobject	Het bedrijf waarin de aandelen worden gehouden.	–	zoals hierboven
shareholdings.holdings.current[].organization.entity_idstring	ID van het bedrijf, voor het bedrijfsprofiel.	`"63529c3a793e9f002196b4fd344e1241"`	zoals hierboven
shareholdings.holdings.current[].organization.namestring\|null	Naam van het bedrijf.	`"Hetzner Cloud GmbH"`	zoals hierboven
shareholdings.holdings.current[].organization.legal_formstring\|null	Rechtsvorm van het bedrijf.	`"GmbH"`	zoals hierboven
shareholdings.holdings.current[].organization.statusstring\|null	Status van het bedrijf in het register, bijvoorbeeld ACTIVE.	`"ACTIVE"`	zoals hierboven
shareholdings.holdings.current[].organization.addressobject\|array	Adres van het bedrijf, opgebouwd zoals address in de basisgegevens.Leeg als er geen adres bekend is; de waarde is dan een lege lijst []	–	zoals hierboven
shareholdings.holdings.current[].organization.registrationobject\|array	Registerinschrijving van het bedrijf met court, register_type en register_number.Leeg als er geen inschrijving bekend is; de waarde is dan een lege lijst []	–	zoals hierboven
shareholdings.holdings.current[].ownership.percentagenumber\|null	Aandeel in procent: 100 betekent 100 %.Leeg als de lijst geen aandeel oplevert	`100`	zoals hierboven
shareholdings.holdings.current[].ownership.contributionobject	Nominaal bedrag van de aandelen met amount en currency.	–	zoals hierboven
shareholdings.holdings.current[].as_ofstring	Datum van de aandeelhouderslijst waar de deelneming vandaan komt.	`"2017-09-19"`	zoals hierboven
shareholdings.summary.total_currentinteger	Aantal huidige deelnemingen.	`2`	zoals hierboven

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholdings": {5    "holdings": {6      "current": [7        {8          "organization": {9            "entity_id": "63529c3a793e9f002196b4fd344e1241",10            "name": "Hetzner Cloud GmbH",11            "status": "ACTIVE",12            "legal_form": "GmbH",13            "address": {14              "house_number": "12A",15              "street": "Feringastraße",16              "postal_code": "85774",17              "city": "Unterföhring",18              "county": "München (Landkreis)",19              "state": "Bayern",20              "country": "DEU",21              "coordinates": {22                "latitude": 48.17815,23                "longitude": 11.6348724              }25            },26            "registration": {27              "court": "München",28              "register_type": "HRB",29              "register_number": "226782"30            }31          },32          "ownership": {33            "percentage": 100,34            "contribution": {35              "amount": 25000,36              "currency": "EUR"37            }38          },39          "as_of": "2017-09-19"40        },41        {42          "organization": {43            "entity_id": "997f1b8314b8b56573208ae2334abb1d",44            "name": "possum Projekt 1 GmbH",45            "status": "ACTIVE",46            "legal_form": "GmbH",47            "address": {48              "house_number": "169-173",49              "street": "Meisenburgstraße",50              "postal_code": "45133",51              "city": "Essen",52              "county": "Essen",53              "state": "Nordrhein-Westfalen",54              "country": "DEU",55              "coordinates": {56                "latitude": 51.40102,57                "longitude": 6.9580558              }59            },60            "registration": {61              "court": "Essen",62              "register_type": "HRB",63              "register_number": "35604"64            }65          },66          "ownership": {67            "percentage": 100,68            "contribution": {69              "amount": 25000,70              "currency": "EUR"71            }72          },73          "as_of": "2026-08-18"74        }75      ]76    },77    "summary": {78      "total_current": 279    }80  }81}

200 · Voorbeeldantwoord: Hetzner Online GmbH met de feature shareholdings

De deelnemingen van een persoon staan in het persoonsprofiel, met dezelfde feature.

Concernstructuren

Concernverbanden stel je samen uit meerdere gegevens. shareholders en shareholdings tonen de deelnemingen één niveau omhoog en omlaag, ubos de personen aan het einde van de keten.

Het Bedrijfsnetwerk verbindt bedrijven en personen over twee niveaus. Het bevat ook verbonden ondernemingen.

Fusies, splitsingen en andere omzettingen staan onder Fusies & overnames.