Ejere og ejerandele – Dokumentation

Feature
Feature	Hvad den returnerer	Kreditter	Tilgængelig
shareholders	Ejere: de nuværende ejere med deres andele og tidligere ejerlister	5	enhver konto · Beta
shareholders_deep	Dybe ejeroplysninger: indehavere med andelsnumre, siden hvornår de har andele, og hvad der senest ændrede sig	80	Max
ubos	Reelle ejere (UBO): personerne bag virksomheden, beregnet ud fra ejerlisterne	10	enhver konto · Beta
shareholdings	Kapitalandele: virksomheder, som virksomheden selv har andele i	5	enhver konto · Beta

Ejere efter selskabsform

Hvad registret siger om ejerne, afhænger af selskabsformen. Tabellen viser, hvad du typisk får.

Selskabsform
Selskabsform	Ejere i svaret
GmbH, UG	Alle ejere fra ejerlisten efter § 40 GmbHG, med nominelt beløb og andel af selskabskapitalen (Stammkapital), plus tidligere lister.
AG, SE, KGaA	Kun i enkelte tilfælde, for aktionærer i en AG står ikke i noget offentligt register.
GmbH & Co. KG	Kommanditisterne (Kommanditisten) fra registret med deres hæftelsesbeløb, delvist også komplementar-GmbH’en.
KG, OHG	De registrerede deltagere: for en KG komplementarerne (Komplementäre) og kommanditisterne, for en OHG de personligt hæftende interessenter.
e.K.	Indehaveren.
eG	Ingen. Et andelsselskabs medlemsliste er ikke offentlig.
PartG	De registrerede partnere.

Ejerlister er ofte scannede dokumenter i mange layouts. Vi udtrækker dem automatisk. Vi bruger den nyeste teknologi til det og investerer meget i kvalitet; enkelte fejl er stadig mulige.

Ejere

Featuren shareholders returnerer de nuværende ejere: for en GmbH fra den nyeste ejerliste, for personselskaber og enkeltmandsvirksomheder fra registret. Den koster 5 kreditter, men kun når den angiver nuværende ejere. Returnerer den kun tidligere lister, koster den intet.

Hver post i entries beskriver en person eller en virksomhed. En person har first_name, last_name og birth_date, en virksomhed entity_name, country_code og registration_reference.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NOEGLE" \
  --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": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholdersobject\|null	Virksomhedens ejere: nuværende tilstand i entries, tidligere tilstande i history.Tom, når der ikke kendes nogen ejere, f.eks. for en AG eller eG`shareholders` · Beta	–	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders.entriesarray	De nuværende ejere, én post pr. person eller virksomhed.	–	som ovenfor
shareholders.entries[].shareholderobject	Hvem der har andelen: en person eller en virksomhed, med felterne nedenfor.	–	som ovenfor
shareholders.entries[].shareholder.entity_idstring\|null	ID for personen eller virksomheden, til dens egen personprofil eller virksomhedsprofil.Tom, når ejeren ikke kunne matches sikkert	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovenfor
shareholders.entries[].shareholder.first_namestring	En persons fornavn, med alle registrerede fornavne.	–	altid: e.K. oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders.entries[].shareholder.last_namestring	En persons efternavn.	–	som ovenfor
shareholders.entries[].shareholder.birth_datestring\|null	En persons fødselsdato, i formatet YYYY-MM-DD.Tom, når dokumentet ikke angiver nogen fødselsdato	–	som ovenfor
shareholders.entries[].shareholder.entity_namestring	Navn på en virksomhed, der er ejer.	`"ENSoXX GmbH"`	oftest: GmbH, UG, GmbH & Co. KG sjældent: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	En virksomheds land som ISO-kode på tre bogstaver (ISO 3166-1 alpha-3), f.eks. DEU.	`"DEU"`	som ovenfor
shareholders.entries[].shareholder.registration_referencestring\|null	En virksomheds registerindførsel som tekst, som den står i dokumentet.Tom, når dokumentet ikke angiver nogen registerindførsel, ofte for udenlandske virksomheder	`"AG Ansbach HRB 6105"`	som ovenfor
shareholders.entries[].shareholder.addressstring\|null	Adresse, bopæl eller hjemsted som tekst, som det står i dokumentet.Tom, når dokumentet ikke angiver nogen adresse	`"Gunzenhausen"`	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders.entries[].contributionobject\|null	Ejerandelens beløb med amount og currency: for en GmbH andelenes nominelle beløb, for kommanditister det registrerede hæftelsesbeløb (Haftsumme).Tom, når der ikke er registreret noget beløb, f.eks. for personligt hæftende deltagere eller indehaveren af en e.K	–	oftest: GmbH, UG, GmbH & Co. KG delvist: KG, OHG sjældent: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Andel af kapitalen som decimaltal: 1 betyder 100 %, 0.245 betyder 24,5 %.Tom, når der ikke kan udledes nogen andel, f.eks. for personselskaber	`0.945`	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders.entries[].roleobject	Rollen: label som fast kode, plus de og en med et langt og et kort navn, f.eks. Kommanditist og Kom.	–	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders.entries[].role.labelstring	Rollen som fast kode. Nye værdier kan komme til.Værdier: `SHAREHOLDER` ejer ifølge ejerlisten, `LIMITED_PARTNER` kommanditist (Kommanditist), `FULLY_LIABLE_PARTNER` personligt hæftende deltager (persönlich haftender Gesellschafter), `PARTNER` partner i en PartG, `OWNER` indehaver af en e.K.	`"SHAREHOLDER"`	som ovenfor
shareholders.total_capitalobject\|null	Kapitalen ifølge ejerlisten, med amount og currency, grundlaget for contribution_ratio.Tom, når listen ikke angiver nogen kapital, samt for personselskaber	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG

Med en ejers entity_id henter du dens egen virksomhedsprofil eller personprofil. Sådan følger du en ejerkæde niveau for niveau.

Ejerhistorik

shareholders.history følger med uden ekstra omkostninger. Den indeholder datoen for den nuværende liste og de tidligere ejerlister, nyeste først.

For en KG eller GmbH & Co. KG står tidligere deltagere i register_ownership, med ind- og udtrædelsesdatoer fra registret. For OHG, PartG og e.K. finder du dem i shareholders_deep.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholders.historyobject	Tidligere tilstande for ejerne, uden ekstra omkostninger.Tom, når der ikke findes tidligere tilstande; feltet mangler så, f.eks. for OHG, PartG eller e.K`shareholders` · Beta	–	oftest: GmbH, UG delvist: GmbH & Co. KG, KG, OHG sjældent: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Dato for den ejerliste, som entries kommer fra.Tom, når ejerne kommer fra registret	`"2015-08-21"`	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders.history.pastarray	Tidligere ejerlister, nyeste først.Tom, når der kun findes én liste	–	som ovenfor
shareholders.history.past[].as_ofstring	Dato for denne ejerliste.	`"2015-07-28"`	som ovenfor
shareholders.history.past[].data.total_capitalobject\|null	Kapitalen ifølge denne liste, med amount og currency. Ældre lister angiver den delvist i DEM.	–	som ovenfor
shareholders.history.past[].data.shareholdersarray	Ejerne ifølge denne liste, med de samme felter som entries.	–	som ovenfor
shareholders.history.register_ownershipobject	For KG og GmbH & Co. KG: tidligere deltagere ifølge registret, i past.	–	delvist: GmbH & Co. KG, KG, OHG aldrig: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Den tidligere deltager, med de samme felter som i entries.	–	som ovenfor
shareholders.history.register_ownership.past[].roleobject	Deltagerens rolle, struktureret som role i entries.	–	som ovenfor
shareholders.history.register_ownership.past[].effective_fromstring\|null	Siden hvornår deltageren var registreret, i formatet YYYY-MM-DD.	`"2022-01-07"`	som ovenfor
shareholders.history.register_ownership.past[].effective_tostring\|null	Indtil hvornår deltageren var registreret.	`"2026-07-06"`	som ovenfor
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true, hvis effective_to er udledt og ikke udtrykkeligt registreret.	`false`	som ovenfor
shareholders.history.register_ownership.past[].contributionnull	Altid null her.	–	som ovenfor
shareholders.history.register_ownership.past[].contribution_rationull	Altid null her.	–	som ovenfor

Dybe ejeroplysninger

Featuren shareholders_deep følger med abonnementet Max. Den koster 80 kreditter, men kun når det nuværende dokument angiver mindst én indehaver.

Den læser alle en virksomheds ejerlister, ikke kun den nyeste. Sådan viser den, siden hvornår nogen har andele, hvordan de tidligere tilstande så ud, og hvad den seneste liste ændrede.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NOEGLE" \
  --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": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Dokumentet. record siger, hvor den nuværende tilstand kommer fra, share_capital angiver kapitalen ifølge dette dokument.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholders_deepobject\|null	Indehavere, andele, tidligere dokumenter og den seneste ændring.Tom, når der ikke kendes noget nuværende dokument og ingen registreret deltager, typisk for AG, SE og eG`shareholders_deep` · fra Max	–	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.recordobject	Det dokument, den nuværende tilstand kommer fra: dato og kilde.	–	som ovenfor
shareholders_deep.record.datestring\|null	Den dato, dokumentet henviser til. Den ligger som regel kort efter den ændring, dokumentet viser.Tom, når ejerne kommer fra registret (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.record.sourcestring	Dokumentets art.Værdier: `SHAREHOLDER_LIST` ejerliste (Gesellschafterliste), `FOUNDING_DOCUMENT` stiftelsesdokument, dvs. Musterprotokoll (standardprotokol) eller Gesellschaftsvertrag (vedtægter), `COMMERCIAL_REGISTER` deltagere eller indehavere registreret i registret	`"SHAREHOLDER_LIST"`	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.share_capitalobject\|null	Kapitalen ifølge dokumentet: value, currency og basis.Tom, når dokumentet ikke angiver nogen kapital, samt altid for COMMERCIAL_REGISTER	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Hvor beløbet kommer fra.Værdier: `REPORTED` angivet i dokumentet, `CALCULATED` beregnet ud fra antal og nominelt beløb for andelene	`"REPORTED"`	som ovenfor

Indehaverne. Hver post i entries er en linje i dokumentet, den største andel først. Har nogen flere linjer, optræder vedkommende flere gange i listen.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholders_deep.entriesarray	De nuværende indehavere, én linje i dokumentet pr. post, den største andel først.`shareholders_deep` · fra Max	–	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holderobject	Hvem der har andelen. type afgør, hvilke felter der følger.	–	som ovenfor
shareholders_deep.entries[].holder.typestring	Indehaverens art.Værdier: `ORGANIZATION` virksomhed eller anden organisation, `PERSON` fysisk person, `JOINT` fælles ejet andel, f.eks. af et dødsbo, med members	`"ORGANIZATION"`	som ovenfor
shareholders_deep.entries[].holder.entity_idstring\|null	Indehaverens ID, til dens egen virksomhedsprofil eller personprofil.Tom, når indehaveren ikke kunne matches sikkert, samt altid for JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovenfor
shareholders_deep.entries[].holder.namestring	Navnet. For matchede indehavere det nuværende navn, ellers som i dokumentet.	`"ENSoXX GmbH"`	som ovenfor
shareholders_deep.entries[].holder.birth_datestring\|null	Kun for personer: fødselsdatoen.Tom, når dokumentet ikke angiver nogen	–	altid: e.K. oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Kun for organisationer: selskabsformen som tekst, f.eks. GmbH eller Ltd.	`"GmbH"`	oftest: GmbH, UG, GmbH & Co. KG sjældent: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Kun for organisationer: den nuværende status i registret.Tom, når indehaveren ikke er matchet, samt altid i de tidligere dokumenter i historyVærdier: `ACTIVE` aktiv, `INACTIVE` ikke længere aktiv, f.eks. slettet eller fusioneret	`"ACTIVE"`	som ovenfor
shareholders_deep.entries[].holder.citystring\|null	Hjemsted eller bopæl.	`"Gunzenhausen"`	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holder.countrystring\|null	Land som ISO-kode på tre bogstaver (ISO 3166-1 alpha-3), f.eks. DEU, AUT eller LUX.	`"DEU"`	som ovenfor
shareholders_deep.entries[].holder.registrationobject\|null	Kun for organisationer: court, register_type og register_number.Tom, når der ikke kan læses nogen registerindførsel, f.eks. for mange udenlandske virksomheder	–	oftest: GmbH, UG, GmbH & Co. KG sjældent: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Kun for organisationer: registerindførslen som tekst, når registration mangler eller ikke angiver nogen ret.	`null`	sjældent
shareholders_deep.entries[].rolestring	Indehaverens rolle. Nye værdier kan komme til.Værdier: `SHAREHOLDER` ejer ifølge ejerliste eller stiftelsesdokument, `LIMITED_PARTNER` kommanditist (Kommanditist), `FULLY_LIABLE_PARTNER` personligt hæftende deltager (persönlich haftender Gesellschafter), `PARTNER` partner i en PartG, `OWNER` indehaver af en e.K.	`"SHAREHOLDER"`	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].sincestring\|null	Siden hvornår indehaveren har andele. For registrerede deltagere datoen for registreringen.Tom, når der ikke kan fastslås nogen dato, samt altid for JOINT	`"2015-08-18"`	som ovenfor
shareholders_deep.entries[].since_basisstring\|null	Hvor sikker since er.Værdier: `ENTRY_RECORDED` dokumenteret fra denne dato: listen før angiver endnu ikke indehaveren, `EARLIEST_RECORD` allerede med i det ældste tilgængelige dokument, altså ejer siden mindst denne dato	`"ENTRY_RECORDED"`	som ovenfor

Andelen. ownership beskriver, hvor meget en indehaver har: i procent, som nominelt beløb og ved andelenes løbenumre.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholders_deep.entries[].ownershipobject	Indehaverens andel.`shareholders_deep` · fra Max	–	oftest: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjældent: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Andel af kapitalen i procent, fra 0 til 100. Det er den direkte ejerandel, ikke stemmerettighederne.Tom, når andelen ikke kan fastslås pålideligt, samt altid for registrerede deltagere i personselskaber	`94.5`	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Hvor percentage kommer fra.Værdier: `REPORTED` angivet i dokumentet eller udledt af nominelt beløb og kapital i dokumentet, `CALCULATED` beregnet ud fra antal og nominelt beløb for andelene	`"REPORTED"`	som ovenfor
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Summen af de nominelle beløb med value og currency. For kommanditister det registrerede hæftelsesbeløb (Haftsumme).Tom, når der ikke kendes noget beløb	–	oftest: GmbH, UG, GmbH & Co. KG delvist: KG, OHG sjældent: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Antal andele (Geschäftsanteile).Tom, når antallet ikke kendes for alle andele	`47250`	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Andelene efter deres løbenumre i listen, ét interval pr. række af ens andele.	–	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Intervallets første løbenummer.	`1`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Intervallets sidste løbenummer.	`47250`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Antal andele i intervallet.	`47250`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Nominelt beløb pr. andel i intervallet, med value og currency.	–	som ovenfor

Historik og ændringer. history indeholder de tidligere dokumenter med de samme felter. Indehaverne optræder dér, som de stod i dokumentet på det tidspunkt. changes sammenligner den nuværende tilstand med den forrige.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholders_deep.historyarray	De tidligere dokumenter, nyeste først, hver med record, share_capital og entries. Tidligere registrerede deltagere er samlet i den sidste post.`shareholders_deep` · fra Max	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	For JOINT: de fælles indehavere af typen PERSON eller ORGANIZATION, med de samme felter som holder.	–	sjældent
shareholders_deep.history[].entries[].untilstring\|null	Kun i den post i history, der har COMMERCIAL_REGISTER: hvornår deltageren udtrådte.	–	delvist: GmbH & Co. KG, KG, OHG, PartG sjældent: e.K. aldrig: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Hvad der ændrede sig med det nuværende dokument i forhold til det forrige.Tom, når der ikke findes noget tidligere dokument, samt når den nuværende tilstand kommer fra registret eller et stiftelsesdokument	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Dato for det forrige dokument.	`"2015-07-16"`	som ovenfor
shareholders_deep.changes.joinedarray	Nye indehavere: holder med entity_id, type og name, plus percentage.	–	som ovenfor
shareholders_deep.changes.leftarray	Indehavere, der er udtrådt, med den andel de senest havde.	–	som ovenfor
shareholders_deep.changes.changedarray	Indehavere, hvis andel har ændret sig.	–	som ovenfor
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Andel i procent i det forrige dokument.	`100`	som ovenfor
shareholders_deep.changes.changed[].percentage_afternumber\|null	Andel i procent i det nuværende dokument.	`5.5`	som ovenfor

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 · Eksempelsvar: Hetzner Online GmbH med featuren shareholders_deep

Sammenlignet med shareholders tilføjer shareholders_deep andelsnumrene, datoen siden hvornår nogen har andele, ændringerne og fælles ejede andele med deres medlemmer. Til sammenligninger på tværs af virksomheder og år er det bedst at bruge den samme feature hele vejen.

Reelle ejere

Reelle ejere er de fysiske personer, der i sidste ende ejer en virksomhed. Featuren ubos følger ejerlisterne gennem ejerniveauerne ned til personerne. Listen angiver hver person med en beregnet andel, uden minimumsgrænse. Den koster 10 kreditter, når den returnerer data.

Kan en andel ikke føres tilbage til en person, står den i unresolved_beneficial_owners med årsagen. Ofte ejes den af en virksomhed i udlandet. Vores data dækker tyske virksomheder, så vi kender ikke ejerne af en virksomhed i udlandet. coverage viser, hvor mange procent af kapitalen der er ført tilbage til personer, og hvor meget der står åbent. De to værdier giver ikke altid 100 tilsammen. For resten angiver ejerdataene ingen indehaver.

Featuren afregnes, så snart den returnerer et resultat. Det gælder også, når alle andele står i unresolved_beneficial_owners.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NOEGLE" \
  --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": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Felt
Felt	Betydning	Eksempel	Tilgængelighed
ubosobject\|null	De reelle ejere, beregnet ud fra ejerlisterne gennem ejerniveauerne.Tom, når der ikke kan bygges nogen kæde ud fra ejerlister, f.eks. for AG, eG eller e.K`ubos` · Beta	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.beneficial_ownersarray	De personer, der ejer virksomheden direkte eller via andre virksomheder.Tom, når ingen andel kan føres tilbage til en person	–	som ovenfor
ubos.beneficial_owners[].personobject	Personen, med felterne nedenfor.	–	delvist: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	Personens ID, til personprofilen.Tom, når personen ikke kunne matches sikkert	–	som ovenfor
ubos.beneficial_owners[].person.namestring	Fulde navn.	–	som ovenfor
ubos.beneficial_owners[].person.name_partsobject	Navnet i dele: given og family, og canonical_name, når det kendes.	–	som ovenfor
ubos.beneficial_owners[].person.birth_datestring\|null	Fødselsdato.	–	som ovenfor
ubos.beneficial_owners[].person.locationobject\|null	Bopæl i home: city, county, state og country.Tom, når der ikke kendes nogen bopæl	–	som ovenfor
ubos.beneficial_owners[].ownership_percentagenumber	Personens samlede andel i procent, lagt sammen over alle veje.	`50`	som ovenfor
ubos.beneficial_owners[].pathsarray	Hver vej til personen, med andelen langs denne vej.	–	som ovenfor
ubos.beneficial_owners[].paths[].percentagenumber	Andel i procent, der kommer frem via denne vej.	`50`	som ovenfor
ubos.beneficial_owners[].paths[].viaarray	Virksomhederne på denne vej, først den direkte ejer af den forespurgte virksomhed (depth 1). Felterne er de samme som i via for de uafklarede andele.Tom, når personen har andele direkte	–	som ovenfor

Felt
Felt	Betydning	Eksempel	Tilgængelighed
ubos.unresolved_beneficial_ownersarray	Andele, der ikke kunne føres tilbage til en person.Tom, når alle andele er afklaret`ubos` · Beta	–	oftest: GmbH, UG sjældent: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Hvorfor kæden ender her. Nye værdier kan komme til.Værdier: `unlinked` ejeren er en virksomhed, som vi ikke kan matche med en indførsel i det tyske register, som regel en virksomhed i udlandet. Vi kender ikke dens ejere, så kæden ender her, `no_further_shareholder_data` ejeren er en tysk virksomhed, som vi kender, men der findes ingen ejerliste for den, f.eks. en KG, `cycle` kæden fører tilbage til en virksomhed, der allerede er i den, f.eks. når en virksomhed ejer sine egne andele, `unknown` der kendes intet om ejeren, hverken navn eller andel	`"cycle"`	som ovenfor
ubos.unresolved_beneficial_owners[].namestring\|null	Navn på den ejer, hvor kæden ender.Tom, når årsagen er unknown	`"ENSoXX Holding AG"`	som ovenfor
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Dens ID, til dens egen virksomhedsprofil.Tom, når ejeren ikke er matchet med en virksomhed i vores data, dvs. ved årsagerne unlinked og unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	som ovenfor
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Dens selskabsform.	`"AG"`	som ovenfor
ubos.unresolved_beneficial_owners[].addressobject\|array	Dens adresse med street, house_number, postal_code, city, county, state, country og coordinates.Tom, når der ikke kendes nogen adresse; værdien er så en tom liste []	–	som ovenfor
ubos.unresolved_beneficial_owners[].registrationobject\|array	Dens registerindførsel med court, register_type og register_number, også fra udenlandske registre.Tom, når der ikke kendes nogen indførsel; værdien er så en tom liste []	–	som ovenfor
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Den uafklarede andel i procent, beregnet igennem til den forespurgte virksomhed. Den kan være 0.	`0`	som ovenfor
ubos.unresolved_beneficial_owners[].viaarray	De virksomheder, kæden går igennem indtil her, først den direkte ejer af den forespurgte virksomhed.Tom, når den uafklarede andel ejes direkte i den forespurgte virksomhed	–	som ovenfor
ubos.unresolved_beneficial_owners[].via[].depthinteger	Niveauet: 1 er en direkte ejer af den forespurgte virksomhed. Ved siden af står virksomhedens name og entity_id.	`1`	som ovenfor
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Andel i procent på dette niveau.	`94.5`	som ovenfor
ubos.coverageobject	Hvor meget af kapitalen der er ført tilbage til personer, og hvor meget der står åbent. De to værdier giver ikke altid 100 tilsammen.	–	som ovenfor
ubos.coverage.resolved_percentagenumber	Ført tilbage til personer, i procent.	`5.5`	som ovenfor
ubos.coverage.unresolved_percentagenumber	Ikke ført tilbage til personer, i procent.	`0`	som ovenfor

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 · Eksempelsvar: Hetzner Online GmbH med featuren ubos. I vores eksempelforespørgsel stod én person med 5,5% i beneficial_owners. Kæden gennem ENSoXX GmbH, Ansbach HRB 6105, endte i unresolved_beneficial_owners med årsagerne cycle og unknown.

Vi beregner dataene ud fra ejerlisterne. Data om reelle ejere fra Transparenzregister (det tyske register over reelle ejere) har ikke været offentligt tilgængelige siden udgangen af 2022.

Kapitalandele

Featuren shareholdings viser den anden retning: hvilke virksomheder den forespurgte virksomhed har andele i. Ejerandelene kommer fra disse virksomheders ejerlister. Den koster 5 kreditter, når der er ejerandele.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NOEGLE" \
  --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": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholdingsobject\|null	De virksomheder, som den forespurgte virksomhed har andele i.Tom, når der ikke kendes nogen ejerandel`shareholdings` · Beta	–	oftest: AG, SE, KGaA delvist: GmbH, UG sjældent: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	De nuværende ejerandele, én pr. virksomhed.	–	som ovenfor
shareholdings.holdings.current[].organizationobject	Den virksomhed, som andelene ejes i.	–	som ovenfor
shareholdings.holdings.current[].organization.entity_idstring	Virksomhedens ID, til dens virksomhedsprofil.	`"63529c3a793e9f002196b4fd344e1241"`	som ovenfor
shareholdings.holdings.current[].organization.namestring\|null	Virksomhedens navn.	`"Hetzner Cloud GmbH"`	som ovenfor
shareholdings.holdings.current[].organization.legal_formstring\|null	Virksomhedens selskabsform.	`"GmbH"`	som ovenfor
shareholdings.holdings.current[].organization.statusstring\|null	Virksomhedens status i registret, f.eks. ACTIVE.	`"ACTIVE"`	som ovenfor
shareholdings.holdings.current[].organization.addressobject\|array	Virksomhedens adresse, struktureret som address i grunddataene.Tom, når der ikke kendes nogen adresse; værdien er så en tom liste []	–	som ovenfor
shareholdings.holdings.current[].organization.registrationobject\|array	Virksomhedens registerindførsel med court, register_type og register_number.Tom, når der ikke kendes nogen indførsel; værdien er så en tom liste []	–	som ovenfor
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel i procent: 100 betyder 100 %.Tom, når listen ikke giver nogen andel	`100`	som ovenfor
shareholdings.holdings.current[].ownership.contributionobject	Andelenes nominelle beløb med amount og currency.	–	som ovenfor
shareholdings.holdings.current[].as_ofstring	Dato for den ejerliste, ejerandelen kommer fra.	`"2017-09-19"`	som ovenfor
shareholdings.summary.total_currentinteger	Antal nuværende ejerandele.	`2`	som ovenfor

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 · Eksempelsvar: Hetzner Online GmbH med featuren shareholdings

En persons ejerandele står i personprofilen, med den samme feature.

Koncernstrukturer

Koncernforbindelser sammensætter du af flere datapunkter. shareholders og shareholdings viser ejerandelene et niveau op og ned, ubos personerne for enden af kæden.

Virksomhedsnetværk forbinder virksomheder og personer over to niveauer. Det omfatter også forbundne virksomheder.

Fusioner, spaltninger og andre omdannelser står under Fusioner & opkøb.