Eiere og eierandeler – Dokumentasjon

Funksjon
Funksjon	Hva den returnerer	Kreditter	Tilgjengelig
shareholders	Eiere: de nåværende eierne med andelene sine og tidligere eierlister	5	hver konto · Beta
shareholders_deep	Dype eierdata: innehavere med andelsnumre, siden når de eier andeler og hva som sist ble endret	80	Max
ubos	Reelle rettighetshavere (UBO): personene bak firmaet, beregnet ut fra eierlistene	10	hver konto · Beta
shareholdings	Eierandeler: firmaer som firmaet selv eier andeler i	5	hver konto · Beta

Eiere etter selskapsform

Hva registeret sier om eierne, avhenger av selskapsformen. Tabellen viser hva du typisk får.

Selskapsform
Selskapsform	Eiere i svaret
GmbH, UG	Alle eiere fra eierlisten etter § 40 GmbHG, med pålydende beløp og andel av aksjekapitalen (Stammkapital), pluss tidligere lister.
AG, SE, KGaA	Bare i enkelttilfeller, fordi aksjonærene i en AG ikke står i noe offentlig register.
GmbH & Co. KG	Kommandittistene (Kommanditisten) fra registeret med ansvarsbeløpet sitt, delvis også komplementar-GmbH-en.
KG, OHG	De registrerte deltakerne: for et KG komplementarene (Komplementäre) og kommandittistene, for et OHG deltakerne med personlig ansvar.
e.K.	Innehaveren.
eG	Ingen. Medlemslisten til et samvirkeforetak er ikke offentlig.
PartG	De registrerte partnerne.

Eierlister er ofte skannede dokumenter i mange oppsett. Vi trekker dem ut automatisk. Vi bruker den nyeste teknologien til dette og investerer mye i kvalitet; enkelte feil er likevel mulige.

Eiere

Funksjonen shareholders returnerer de nåværende eierne: for en GmbH fra den nyeste eierlisten, for personselskaper og enkeltpersonforetak fra registeret. Den koster 5 kreditter, men bare når den nevner nåværende eiere. Returnerer den bare tidligere lister, koster den ingenting.

Hver oppføring i entries beskriver en person eller et firma. En person har first_name, last_name og birth_date, et firma entity_name, country_code og registration_reference.

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

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholdersobject\|null	Firmaets eiere: aktuell tilstand i entries, tidligere tilstander i history.Tom når ingen eiere er kjent, for eksempel for en AG eller eG`shareholders` · Beta	–	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders.entriesarray	De nåværende eierne, én oppføring per person eller firma.	–	som ovenfor
shareholders.entries[].shareholderobject	Hvem som eier andelen: en person eller et firma, med feltene nedenfor.	–	som ovenfor
shareholders.entries[].shareholder.entity_idstring\|null	ID-en til personen eller firmaet, for egen personprofil eller firmaprofil.Tom når eieren ikke kunne matches sikkert	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovenfor
shareholders.entries[].shareholder.first_namestring	Fornavn til en person, med alle registrerte fornavn.	–	alltid: e.K. som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sjelden: AG, SE, KGaA aldri: eG
shareholders.entries[].shareholder.last_namestring	Etternavn til en person.	–	som ovenfor
shareholders.entries[].shareholder.birth_datestring\|null	Fødselsdato til en person, i formatet YYYY-MM-DD.Tom når dokumentet ikke oppgir noen fødselsdato	–	som ovenfor
shareholders.entries[].shareholder.entity_namestring	Navnet på et firma som er eier.	`"ENSoXX GmbH"`	som regel: GmbH, UG, GmbH & Co. KG sjelden: AG, SE, KGaA, KG, OHG aldri: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Landet til et firma som tre bokstavers ISO-kode (ISO 3166-1 alpha-3), for eksempel DEU.	`"DEU"`	som ovenfor
shareholders.entries[].shareholder.registration_referencestring\|null	Registeroppføringen til et firma som tekst, slik den står i dokumentet.Tom når dokumentet ikke oppgir noen registeroppføring, ofte for utenlandske firmaer	`"AG Ansbach HRB 6105"`	som ovenfor
shareholders.entries[].shareholder.addressstring\|null	Adresse, bosted eller forretningskontor som tekst, slik det står i dokumentet.Tom når dokumentet ikke oppgir noen adresse	`"Gunzenhausen"`	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders.entries[].contributionobject\|null	Beløpet for eierandelen med amount og currency: for en GmbH det pålydende beløpet for andelene, for kommandittister det registrerte ansvarsbeløpet (Haftsumme).Tom når ikke noe beløp er registrert, for eksempel for deltakere med personlig ansvar eller innehaveren av et e.K	–	som regel: GmbH, UG, GmbH & Co. KG delvis: KG, OHG sjelden: AG, SE, KGaA aldri: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Andel av kapitalen som desimaltall: 1 betyr 100 %, 0.245 betyr 24,5 %.Tom når ingen andel kan utledes, for eksempel for personselskaper	`0.945`	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders.entries[].roleobject	Rollen: label som fast kode, pluss de og en med et langt og et kort navn, for eksempel Kommanditist og Kom.	–	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders.entries[].role.labelstring	Rollen som fast kode. Nye verdier kan komme til.Verdier: `SHAREHOLDER` eier ifølge eierlisten, `LIMITED_PARTNER` kommandittist (Kommanditist), `FULLY_LIABLE_PARTNER` deltaker med personlig ansvar (persönlich haftender Gesellschafter), `PARTNER` partner i et PartG, `OWNER` innehaver av et e.K.	`"SHAREHOLDER"`	som ovenfor
shareholders.total_capitalobject\|null	Kapitalen ifølge eierlisten, med amount og currency, grunnlaget for contribution_ratio.Tom når listen ikke oppgir noen kapital, og for personselskaper	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG

Med en eiers entity_id henter du eierens egen firmaprofil eller personprofil. Slik følger du en eierkjede nivå for nivå.

Eierhistorikk

shareholders.history følger med uten ekstra kostnad. Den inneholder datoen for den aktuelle listen og de tidligere eierlistene, de nyeste først.

For et KG eller GmbH & Co. KG står tidligere deltakere i register_ownership, med inntredelses- og uttredelsesdatoer fra registeret. For OHG, PartG og e.K. finner du dem i shareholders_deep.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholders.historyobject	Tidligere tilstander for eierne, uten ekstra kostnad.Tom når det ikke finnes tidligere tilstander; feltet mangler da, for eksempel for OHG, PartG eller e.K`shareholders` · Beta	–	som regel: GmbH, UG delvis: GmbH & Co. KG, KG, OHG sjelden: AG, SE, KGaA aldri: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Dato for eierlisten som entries kommer fra.Tom når eierne kommer fra registeret	`"2015-08-21"`	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders.history.pastarray	Tidligere eierlister, de nyeste først.Tom når det bare finnes én liste	–	som ovenfor
shareholders.history.past[].as_ofstring	Dato for denne eierlisten.	`"2015-07-28"`	som ovenfor
shareholders.history.past[].data.total_capitalobject\|null	Kapitalen ifølge denne listen, med amount og currency. Eldre lister oppgir den delvis i DEM.	–	som ovenfor
shareholders.history.past[].data.shareholdersarray	Eierne ifølge denne listen, med de samme feltene som entries.	–	som ovenfor
shareholders.history.register_ownershipobject	For KG og GmbH & Co. KG: tidligere deltakere ifølge registeret, i past.	–	delvis: GmbH & Co. KG, KG, OHG aldri: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Den tidligere deltakeren, med de samme feltene som i entries.	–	som ovenfor
shareholders.history.register_ownership.past[].roleobject	Rollen deres, bygget opp som role i entries.	–	som ovenfor
shareholders.history.register_ownership.past[].effective_fromstring\|null	Siden når de var registrert, i formatet YYYY-MM-DD.	`"2022-01-07"`	som ovenfor
shareholders.history.register_ownership.past[].effective_tostring\|null	Til når de var registrert.	`"2026-07-06"`	som ovenfor
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true hvis effective_to er utledet og ikke eksplisitt registrert.	`false`	som ovenfor
shareholders.history.register_ownership.past[].contributionnull	Alltid null her.	–	som ovenfor
shareholders.history.register_ownership.past[].contribution_rationull	Alltid null her.	–	som ovenfor

Dype eierdata

Funksjonen shareholders_deep følger med abonnementet Max. Den koster 80 kreditter, men bare når det aktuelle dokumentet nevner minst én innehaver.

Den leser alle eierlistene til et firma, ikke bare den nyeste. Slik viser den siden når noen eier andeler, hvordan de tidligere tilstandene så ut, og hva den siste listen endret.

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

Dokumentet. record sier hvor den aktuelle tilstanden kommer fra, share_capital angir kapitalen ifølge dette dokumentet.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholders_deepobject\|null	Innehavere, andeler, tidligere dokumenter og den siste endringen.Tom når verken et aktuelt dokument eller en registrert deltaker er kjent, typisk for AG, SE og eG`shareholders_deep` · fra Max	–	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.recordobject	Dokumentet den aktuelle tilstanden kommer fra: dato og kilde.	–	som ovenfor
shareholders_deep.record.datestring\|null	Datoen dokumentet viser til. Den ligger som regel kort etter endringen dokumentet viser.Tom når eierne kommer fra registeret (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.record.sourcestring	Typen dokument.Verdier: `SHAREHOLDER_LIST` eierliste (Gesellschafterliste), `FOUNDING_DOCUMENT` stiftelsesdokument, altså Musterprotokoll (standardprotokoll) eller Gesellschaftsvertrag (vedtekter), `COMMERCIAL_REGISTER` deltakere eller innehavere registrert i registeret	`"SHAREHOLDER_LIST"`	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.share_capitalobject\|null	Kapitalen ifølge dokumentet: value, currency og basis.Tom når dokumentet ikke oppgir noen kapital, og alltid for COMMERCIAL_REGISTER	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Hvor beløpet kommer fra.Verdier: `REPORTED` oppgitt i dokumentet, `CALCULATED` beregnet ut fra antall og pålydende beløp for andelene	`"REPORTED"`	som ovenfor

Innehaverne. Hver oppføring i entries er én linje i dokumentet, den største andelen først. Har noen flere linjer, vises de flere ganger i listen.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholders_deep.entriesarray	De nåværende innehaverne, én linje i dokumentet per oppføring, den største andelen først.`shareholders_deep` · fra Max	–	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.entries[].holderobject	Hvem som eier andelen. type avgjør hvilke felt som følger.	–	som ovenfor
shareholders_deep.entries[].holder.typestring	Typen innehaver.Verdier: `ORGANIZATION` firma eller annen organisasjon, `PERSON` fysisk person, `JOINT` felleseid andel, for eksempel i et arvefellesskap, med members	`"ORGANIZATION"`	som ovenfor
shareholders_deep.entries[].holder.entity_idstring\|null	ID-en til innehaveren, for egen firmaprofil eller personprofil.Tom når innehaveren ikke kunne matches sikkert, og alltid for JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovenfor
shareholders_deep.entries[].holder.namestring	Navnet. For matchede innehavere det aktuelle navnet, ellers som i dokumentet.	`"ENSoXX GmbH"`	som ovenfor
shareholders_deep.entries[].holder.birth_datestring\|null	Bare for personer: fødselsdatoen.Tom når dokumentet ikke oppgir noen	–	alltid: e.K. som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Bare for organisasjoner: selskapsformen som tekst, for eksempel GmbH eller Ltd.	`"GmbH"`	som regel: GmbH, UG, GmbH & Co. KG sjelden: AG, SE, KGaA, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Bare for organisasjoner: den aktuelle statusen i registeret.Tom når innehaveren ikke er matchet, og alltid i de tidligere dokumentene i historyVerdier: `ACTIVE` aktiv, `INACTIVE` ikke lenger aktiv, for eksempel slettet eller fusjonert	`"ACTIVE"`	som ovenfor
shareholders_deep.entries[].holder.citystring\|null	Forretningskontor eller bosted.	`"Gunzenhausen"`	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.entries[].holder.countrystring\|null	Land som tre bokstavers ISO-kode (ISO 3166-1 alpha-3), for eksempel DEU, AUT eller LUX.	`"DEU"`	som ovenfor
shareholders_deep.entries[].holder.registrationobject\|null	Bare for organisasjoner: court, register_type og register_number.Tom når ingen registeroppføring kan leses, for eksempel for mange utenlandske firmaer	–	som regel: GmbH, UG, GmbH & Co. KG sjelden: AG, SE, KGaA, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Bare for organisasjoner: registeroppføringen som tekst, når registration mangler eller ikke nevner noen domstol.	`null`	sjelden
shareholders_deep.entries[].rolestring	Innehaverens rolle. Nye verdier kan komme til.Verdier: `SHAREHOLDER` eier ifølge eierlisten eller stiftelsesdokumentet, `LIMITED_PARTNER` kommandittist (Kommanditist), `FULLY_LIABLE_PARTNER` deltaker med personlig ansvar (persönlich haftender Gesellschafter), `PARTNER` partner i et PartG, `OWNER` innehaver av et e.K.	`"SHAREHOLDER"`	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.entries[].sincestring\|null	Siden når innehaveren eier andeler. For registrerte deltakere datoen for registreringen.Tom når ingen dato kan fastslås, og alltid for JOINT	`"2015-08-18"`	som ovenfor
shareholders_deep.entries[].since_basisstring\|null	Hvor sikker since er.Verdier: `ENTRY_RECORDED` dokumentert fra denne datoen: listen før nevner ennå ikke innehaveren, `EARLIEST_RECORD` allerede med i det eldste tilgjengelige dokumentet, altså eier siden minst denne datoen	`"ENTRY_RECORDED"`	som ovenfor

Andelen. ownership beskriver hvor mye en innehaver eier: i prosent, som pålydende beløp og via løpenumrene til andelene.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholders_deep.entries[].ownershipobject	Innehaverens andel.`shareholders_deep` · fra Max	–	som regel: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sjelden: AG, SE, KGaA aldri: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Andel av kapitalen i prosent, fra 0 til 100. Dette er den direkte eierandelen, ikke stemmerettighetene.Tom når andelen ikke kan fastslås pålitelig, og alltid for registrerte deltakere i personselskaper	`94.5`	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Hvor percentage kommer fra.Verdier: `REPORTED` oppgitt i dokumentet eller utledet av pålydende beløp og kapital i dokumentet, `CALCULATED` beregnet ut fra antall og pålydende beløp for andelene	`"REPORTED"`	som ovenfor
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Summen av de pålydende beløpene med value og currency. For kommandittister det registrerte ansvarsbeløpet (Haftsumme).Tom når ikke noe beløp er kjent	–	som regel: GmbH, UG, GmbH & Co. KG delvis: KG, OHG sjelden: AG, SE, KGaA aldri: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Antall andeler (Geschäftsanteile).Tom når antallet ikke er kjent for alle andeler	`47250`	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Andelene via løpenumrene sine i listen, ett intervall per rekke av like andeler.	–	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Første løpenummer i intervallet.	`1`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Siste løpenummer i intervallet.	`47250`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Antall andeler i intervallet.	`47250`	som ovenfor
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Pålydende beløp per andel i intervallet, med value og currency.	–	som ovenfor

Historikk og endringer. history inneholder de tidligere dokumentene med de samme feltene. Innehaverne står der slik de sto i dokumentet den gangen. changes sammenligner den aktuelle tilstanden med den forrige.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholders_deep.historyarray	De tidligere dokumentene, de nyeste først, hvert med record, share_capital og entries. Tidligere registrerte deltakere er samlet i den siste oppføringen.`shareholders_deep` · fra Max	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	For JOINT: de felles innehaverne av typen PERSON eller ORGANIZATION, med de samme feltene som holder.	–	sjelden
shareholders_deep.history[].entries[].untilstring\|null	Bare i elementet i history med COMMERCIAL_REGISTER: når deltakeren gikk ut.	–	delvis: GmbH & Co. KG, KG, OHG, PartG sjelden: e.K. aldri: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Hva som endret seg med det aktuelle dokumentet sammenlignet med det forrige.Tom når det ikke finnes noe tidligere dokument, og når den aktuelle tilstanden kommer fra registeret eller et stiftelsesdokument	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Dato for det forrige dokumentet.	`"2015-07-16"`	som ovenfor
shareholders_deep.changes.joinedarray	Nye innehavere: holder med entity_id, type og name, pluss percentage.	–	som ovenfor
shareholders_deep.changes.leftarray	Innehavere som gikk ut, med andelen de sist hadde.	–	som ovenfor
shareholders_deep.changes.changedarray	Innehavere der andelen endret seg.	–	som ovenfor
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Andel i prosent i det forrige dokumentet.	`100`	som ovenfor
shareholders_deep.changes.changed[].percentage_afternumber\|null	Andel i prosent i det aktuelle dokumentet.	`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 funksjonen shareholders_deep

Sammenlignet med shareholders legger shareholders_deep til andelsnumrene, datoen siden noen eier andeler, endringene og felleseide andeler med medlemmene sine. For sammenligninger på tvers av firmaer og år bruker du helst den samme funksjonen hele veien.

Reelle rettighetshavere

Reelle rettighetshavere er de fysiske personene som til syvende og sist eier et firma. Funksjonen ubos følger eierlistene over eiernivåene ned til personene. Listen nevner hver person med en beregnet andel, uten nedre terskel. Den koster 10 kreditter når den returnerer data.

Kan en andel ikke spores til en person, står den i unresolved_beneficial_owners med årsaken. Ofte eies den av et firma i utlandet. Dataene våre dekker tyske firmaer, så vi kjenner ikke eierne til et firma i utlandet. coverage viser hvor mange prosent av kapitalen som er sporet til personer, og hvor mye som forblir åpent. De to verdiene blir ikke alltid 100 til sammen. For resten nevner eierdataene ingen innehaver.

Funksjonen belastes så snart den returnerer et resultat. Det gjelder også når alle andeler står i unresolved_beneficial_owners.

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

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
ubosobject\|null	De reelle rettighetshaverne, beregnet ut fra eierlistene over eiernivåene.Tom når ingen kjede kan bygges ut fra eierlister, for eksempel for AG, eG eller e.K`ubos` · Beta	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
ubos.beneficial_ownersarray	Personene som eier firmaet direkte eller via andre firmaer.Tom når ingen andel kan spores til en person	–	som ovenfor
ubos.beneficial_owners[].personobject	Personen, med feltene nedenfor.	–	delvis: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	Personens ID, for personprofilen.Tom når personen ikke kunne matches sikkert	–	som ovenfor
ubos.beneficial_owners[].person.namestring	Fullt navn.	–	som ovenfor
ubos.beneficial_owners[].person.name_partsobject	Navnet i deler: given og family, og canonical_name når det er kjent.	–	som ovenfor
ubos.beneficial_owners[].person.birth_datestring\|null	Fødselsdato.	–	som ovenfor
ubos.beneficial_owners[].person.locationobject\|null	Bosted i home: city, county, state og country.Tom når ikke noe bosted er kjent	–	som ovenfor
ubos.beneficial_owners[].ownership_percentagenumber	Personens samlede andel i prosent, summert over alle veier.	`50`	som ovenfor
ubos.beneficial_owners[].pathsarray	Hver vei til personen, med andelen langs denne veien.	–	som ovenfor
ubos.beneficial_owners[].paths[].percentagenumber	Andel i prosent som kommer frem via denne veien.	`50`	som ovenfor
ubos.beneficial_owners[].paths[].viaarray	Firmaene på denne veien, først den direkte eieren av det forespurte firmaet (depth 1). Feltene er de samme som i via for de uoppløste andelene.Tom når personen eier andeler direkte	–	som ovenfor

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
ubos.unresolved_beneficial_ownersarray	Andeler som ikke kunne spores til en person.Tom når alle andeler er oppløst`ubos` · Beta	–	som regel: GmbH, UG sjelden: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldri: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Hvorfor kjeden slutter her. Nye verdier kan komme til.Verdier: `unlinked` eieren er et firma som vi ikke kan knytte til en oppføring i det tyske registeret, som regel et firma i utlandet. Vi kjenner ikke eierne, så kjeden slutter her, `no_further_shareholder_data` eieren er et tysk firma som vi kjenner, men det finnes ingen eierliste for det, for eksempel et KG, `cycle` kjeden fører tilbake til et firma som allerede er med i den, for eksempel når et firma eier egne andeler, `unknown` ingenting er kjent om eieren, verken navn eller andel	`"cycle"`	som ovenfor
ubos.unresolved_beneficial_owners[].namestring\|null	Navnet på eieren der kjeden slutter.Tom når årsaken er unknown	`"ENSoXX Holding AG"`	som ovenfor
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Eierens ID, for egen firmaprofil.Tom når eieren ikke er knyttet til et firma i dataene våre, altså for årsakene unlinked og unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	som ovenfor
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Eierens selskapsform.	`"AG"`	som ovenfor
ubos.unresolved_beneficial_owners[].addressobject\|array	Eierens adresse med street, house_number, postal_code, city, county, state, country og coordinates.Tom når ingen adresse er kjent; verdien er da en tom liste []	–	som ovenfor
ubos.unresolved_beneficial_owners[].registrationobject\|array	Eierens registeroppføring med court, register_type og register_number, også fra utenlandske registre.Tom når ingen oppføring er kjent; verdien er da en tom liste []	–	som ovenfor
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Den uoppløste andelen i prosent, beregnet helt frem til det forespurte firmaet. Den kan være 0.	`0`	som ovenfor
ubos.unresolved_beneficial_owners[].viaarray	Firmaene kjeden går gjennom frem hit, først den direkte eieren av det forespurte firmaet.Tom når den uoppløste andelen eies direkte i det forespurte firmaet	–	som ovenfor
ubos.unresolved_beneficial_owners[].via[].depthinteger	Nivået: 1 er en direkte eier av det forespurte firmaet. Ved siden av står firmaets name og entity_id.	`1`	som ovenfor
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Andel i prosent på dette nivået.	`94.5`	som ovenfor
ubos.coverageobject	Hvor mye av kapitalen som er sporet til personer, og hvor mye som forblir åpent. De to verdiene blir ikke alltid 100 til sammen.	–	som ovenfor
ubos.coverage.resolved_percentagenumber	Sporet til personer, i prosent.	`5.5`	som ovenfor
ubos.coverage.unresolved_percentagenumber	Ikke sporet til personer, i prosent.	`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 funksjonen ubos. I eksempelforespørselen vår sto én person med 5,5 % i beneficial_owners. Kjeden gjennom ENSoXX GmbH, Ansbach HRB 6105, endte i unresolved_beneficial_owners med årsakene cycle og unknown.

Dataene beregner vi ut fra eierlistene. Data om reelle rettighetshavere fra Transparenzregister (åpenhetsregisteret) har ikke vært offentlig tilgjengelige siden slutten av 2022.

Eierandeler

Funksjonen shareholdings viser den andre retningen: hvilke firmaer det forespurte firmaet eier andeler i. Eierandelene kommer fra eierlistene til disse firmaene. Den koster 5 kreditter når det finnes eierandeler.

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

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholdingsobject\|null	Firmaene som det forespurte firmaet eier andeler i.Tom når ingen eierandel er kjent`shareholdings` · Beta	–	som regel: AG, SE, KGaA delvis: GmbH, UG sjelden: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	De nåværende eierandelene, én per firma.	–	som ovenfor
shareholdings.holdings.current[].organizationobject	Firmaet som andelene eies i.	–	som ovenfor
shareholdings.holdings.current[].organization.entity_idstring	Firmaets ID, for firmaprofilen.	`"63529c3a793e9f002196b4fd344e1241"`	som ovenfor
shareholdings.holdings.current[].organization.namestring\|null	Firmaets navn.	`"Hetzner Cloud GmbH"`	som ovenfor
shareholdings.holdings.current[].organization.legal_formstring\|null	Firmaets selskapsform.	`"GmbH"`	som ovenfor
shareholdings.holdings.current[].organization.statusstring\|null	Firmaets status i registeret, for eksempel ACTIVE.	`"ACTIVE"`	som ovenfor
shareholdings.holdings.current[].organization.addressobject\|array	Firmaets adresse, bygget opp som address i grunndataene.Tom når ingen adresse er kjent; verdien er da en tom liste []	–	som ovenfor
shareholdings.holdings.current[].organization.registrationobject\|array	Firmaets registeroppføring med court, register_type og register_number.Tom når ingen oppføring er kjent; verdien er da en tom liste []	–	som ovenfor
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel i prosent: 100 betyr 100 %.Tom når listen ikke gir noen andel	`100`	som ovenfor
shareholdings.holdings.current[].ownership.contributionobject	Pålydende beløp for andelene med amount og currency.	–	som ovenfor
shareholdings.holdings.current[].as_ofstring	Dato for eierlisten eierandelen kommer fra.	`"2017-09-19"`	som ovenfor
shareholdings.summary.total_currentinteger	Antall nåværende eierandeler.	`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 funksjonen shareholdings

Eierandelene til en person står i personprofilen, med den samme funksjonen.

Konsernstrukturer

Konsernforbindelser setter du sammen av flere datapunkter. shareholders og shareholdings viser eierandelene ett nivå opp og ned, ubos personene i enden av kjeden.

Firmanettverk knytter sammen firmaer og personer over to nivåer. Det omfatter også tilknyttede firmaer.

Fusjoner, fisjoner og andre omdannelser står under Fusjoner og oppkjøp.