Delägare och innehav – Dokumentation

Funktion
Funktion	Vad den returnerar	Krediter	Tillgänglig
shareholders	Delägare: de nuvarande delägarna med sina andelar och tidigare delägarförteckningar	5	varje konto · Beta
shareholders_deep	Fördjupade delägardata: innehavare med andelsnummer, sedan när de äger andelar och vad som senast ändrades	80	Max
ubos	Verkliga huvudmän (UBO): personerna bakom företaget, beräknade ur delägarförteckningarna	10	varje konto · Beta
shareholdings	Innehav: företag där företaget självt äger andelar	5	varje konto · Beta

Delägare per bolagsform

Vad registret säger om ägarna beror på bolagsformen. Tabellen visar vad du typiskt får.

Bolagsform
Bolagsform	Delägare i svaret
GmbH, UG	Alla delägare från delägarförteckningen enligt § 40 GmbHG, med nominellt belopp och andel av aktiekapitalet (Stammkapital), plus tidigare förteckningar.
AG, SE, KGaA	Bara i enskilda fall, eftersom aktieägare i ett AG inte står i något offentligt register.
GmbH & Co. KG	Kommanditdelägarna (Kommanditisten) från registret med sitt ansvarsbelopp, delvis även komplementär-GmbH:n.
KG, OHG	De registrerade bolagsmännen: för ett KG komplementärerna (Komplementäre) och kommanditdelägarna, för ett OHG de personligt ansvariga bolagsmännen.
e.K.	Ägaren.
eG	Inga. Ett kooperativs medlemsförteckning är inte offentlig.
PartG	De registrerade partnerna.

Delägarförteckningar är ofta skannade dokument i många layouter. Vi extraherar dem automatiskt. Vi använder den senaste tekniken för detta och investerar mycket i kvalitet; enskilda fel är ändå möjliga.

Delägare

Funktionen shareholders returnerar de nuvarande delägarna: för en GmbH från den senaste delägarförteckningen, för personbolag och enskilda näringsidkare från registret. Den kostar 5 krediter, men bara när den nämner nuvarande delägare. Om den bara returnerar tidigare förteckningar kostar den ingenting.

Varje post i entries beskriver en person eller ett företag. En person har first_name, last_name och birth_date, ett företag entity_name, country_code och registration_reference.

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

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholdersobject\|null	Företagets delägare: aktuellt läge i entries, tidigare tillstånd i history.Tomt när inga delägare är kända, till exempel för ett AG eller eG`shareholders` · Beta	–	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders.entriesarray	De nuvarande delägarna, en post per person eller företag.	–	som ovan
shareholders.entries[].shareholderobject	Vem som innehar andelen: en person eller ett företag, med fälten nedan.	–	som ovan
shareholders.entries[].shareholder.entity_idstring\|null	Personens eller företagets ID, för dess egen personprofil eller företagsprofil.Tomt när delägaren inte kunde matchas med säkerhet	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovan
shareholders.entries[].shareholder.first_namestring	En persons förnamn, med alla registrerade förnamn.	–	alltid: e.K. oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sällan: AG, SE, KGaA aldrig: eG
shareholders.entries[].shareholder.last_namestring	En persons efternamn.	–	som ovan
shareholders.entries[].shareholder.birth_datestring\|null	En persons födelsedatum, i formatet YYYY-MM-DD.Tomt när dokumentet inte anger något födelsedatum	–	som ovan
shareholders.entries[].shareholder.entity_namestring	Namn på ett företag som är delägare.	`"ENSoXX GmbH"`	oftast: GmbH, UG, GmbH & Co. KG sällan: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Ett företags land som trebokstavskod enligt ISO (ISO 3166-1 alpha-3), till exempel DEU.	`"DEU"`	som ovan
shareholders.entries[].shareholder.registration_referencestring\|null	Ett företags registeranteckning som text, så som den står i dokumentet.Tomt när dokumentet inte anger någon registeranteckning, ofta för utländska företag	`"AG Ansbach HRB 6105"`	som ovan
shareholders.entries[].shareholder.addressstring\|null	Adress, bostadsort eller säte som text, så som det står i dokumentet.Tomt när dokumentet inte anger någon adress	`"Gunzenhausen"`	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders.entries[].contributionobject\|null	Delägarskapets belopp med amount och currency: för en GmbH andelarnas nominella belopp, för kommanditdelägare det registrerade ansvarsbeloppet (Haftsumme).Tomt när inget belopp är registrerat, till exempel för personligt ansvariga bolagsmän eller ägaren till en e.K	–	oftast: GmbH, UG, GmbH & Co. KG delvis: KG, OHG sällan: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Andel av kapitalet som decimaltal: 1 betyder 100 %, 0.245 betyder 24,5 %.Tomt när ingen andel kan härledas, till exempel för personbolag	`0.945`	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders.entries[].roleobject	Rollen: label som fast kod, plus de och en med ett långt och ett kort namn, till exempel Kommanditist och Kom.	–	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders.entries[].role.labelstring	Rollen som fast kod. Nya värden kan tillkomma.Värden: `SHAREHOLDER` delägare enligt delägarförteckningen, `LIMITED_PARTNER` kommanditdelägare (Kommanditist), `FULLY_LIABLE_PARTNER` personligt ansvarig bolagsman (persönlich haftender Gesellschafter), `PARTNER` partner i ett PartG, `OWNER` ägare till en e.K.	`"SHAREHOLDER"`	som ovan
shareholders.total_capitalobject\|null	Kapitalet enligt delägarförteckningen, med amount och currency, grunden för contribution_ratio.Tomt när förteckningen inte anger något kapital, samt för personbolag	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG

Med en delägares entity_id hämtar du dess egen företagsprofil eller personprofil. Så följer du en ägarkedja nivå för nivå.

Delägarhistorik

shareholders.history ingår utan extra kostnad. Den innehåller datumet för den aktuella förteckningen och de tidigare delägarförteckningarna, de senaste först.

För ett KG eller GmbH & Co. KG står tidigare bolagsmän i register_ownership, med in- och utträdesdatum från registret. För OHG, PartG och e.K. hittar du dem i shareholders_deep.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholders.historyobject	Delägarnas tidigare tillstånd, utan extra kostnad.Tomt när inga tidigare tillstånd finns; fältet saknas då, till exempel för OHG, PartG eller e.K`shareholders` · Beta	–	oftast: GmbH, UG delvis: GmbH & Co. KG, KG, OHG sällan: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Datum för den delägarförteckning som entries kommer från.Tomt när delägarna kommer från registret	`"2015-08-21"`	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders.history.pastarray	Tidigare delägarförteckningar, de senaste först.Tomt när bara en förteckning finns	–	som ovan
shareholders.history.past[].as_ofstring	Datum för denna delägarförteckning.	`"2015-07-28"`	som ovan
shareholders.history.past[].data.total_capitalobject\|null	Kapitalet enligt denna förteckning, med amount och currency. Äldre förteckningar anger det delvis i DEM.	–	som ovan
shareholders.history.past[].data.shareholdersarray	Delägarna enligt denna förteckning, med samma fält som entries.	–	som ovan
shareholders.history.register_ownershipobject	För KG och GmbH & Co. KG: tidigare bolagsmän enligt registret, i past.	–	delvis: GmbH & Co. KG, KG, OHG aldrig: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Den tidigare bolagsmannen, med samma fält som i entries.	–	som ovan
shareholders.history.register_ownership.past[].roleobject	Rollen, uppbyggd som role i entries.	–	som ovan
shareholders.history.register_ownership.past[].effective_fromstring\|null	Sedan när bolagsmannen var registrerad, i formatet YYYY-MM-DD.	`"2022-01-07"`	som ovan
shareholders.history.register_ownership.past[].effective_tostring\|null	Till när bolagsmannen var registrerad.	`"2026-07-06"`	som ovan
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true om effective_to är härlett och inte uttryckligen registrerat.	`false`	som ovan
shareholders.history.register_ownership.past[].contributionnull	Här alltid null.	–	som ovan
shareholders.history.register_ownership.past[].contribution_rationull	Här alltid null.	–	som ovan

Fördjupade delägardata

Funktionen shareholders_deep ingår i planen Max. Den kostar 80 krediter, men bara när det aktuella dokumentet nämner minst en innehavare.

Den läser alla delägarförteckningar för ett företag, inte bara den senaste. Så visar den sedan när någon äger andelar, hur de tidigare tillstånden såg ut och vad den senaste förteckningen ändrade.

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

Dokumentet. record anger var det aktuella läget kommer ifrån, share_capital anger kapitalet enligt det dokumentet.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholders_deepobject\|null	Innehavare, andelar, tidigare dokument och den senaste ändringen.Tomt när inget aktuellt dokument och ingen registrerad bolagsman är känd, typiskt för AG, SE och eG`shareholders_deep` · från Max	–	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.recordobject	Det dokument som det aktuella läget kommer från: datum och källa.	–	som ovan
shareholders_deep.record.datestring\|null	Det datum som dokumentet avser. Det ligger oftast kort efter den ändring som dokumentet visar.Tomt när delägarna kommer från registret (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.record.sourcestring	Typen av dokument.Värden: `SHAREHOLDER_LIST` delägarförteckning (Gesellschafterliste), `FOUNDING_DOCUMENT` stiftelsedokument, alltså Musterprotokoll (standardprotokoll) eller Gesellschaftsvertrag (bolagsordning), `COMMERCIAL_REGISTER` bolagsmän eller ägare som är registrerade i registret	`"SHAREHOLDER_LIST"`	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.share_capitalobject\|null	Kapitalet enligt dokumentet: value, currency och basis.Tomt när dokumentet inte anger något kapital, samt alltid för COMMERCIAL_REGISTER	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Var beloppet kommer ifrån.Värden: `REPORTED` angivet i dokumentet, `CALCULATED` beräknat ur antal och nominellt belopp för andelarna	`"REPORTED"`	som ovan

Innehavarna. Varje post i entries är en rad i dokumentet, den största andelen först. Om någon har flera rader förekommer personen flera gånger i listan.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholders_deep.entriesarray	De nuvarande innehavarna, en rad i dokumentet per post, den största andelen först.`shareholders_deep` · från Max	–	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holderobject	Vem som innehar andelen. type avgör vilka fält som följer.	–	som ovan
shareholders_deep.entries[].holder.typestring	Typen av innehavare.Värden: `ORGANIZATION` företag eller annan organisation, `PERSON` fysisk person, `JOINT` gemensamt ägd andel, till exempel för ett dödsbo, med members	`"ORGANIZATION"`	som ovan
shareholders_deep.entries[].holder.entity_idstring\|null	Innehavarens ID, för dess egen företagsprofil eller personprofil.Tomt när innehavaren inte kunde matchas med säkerhet, samt alltid för JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	som ovan
shareholders_deep.entries[].holder.namestring	Namnet. För matchade innehavare det aktuella namnet, annars som i dokumentet.	`"ENSoXX GmbH"`	som ovan
shareholders_deep.entries[].holder.birth_datestring\|null	Bara för personer: födelsedatumet.Tomt när dokumentet inte anger något	–	alltid: e.K. oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Bara för organisationer: bolagsformen som text, till exempel GmbH eller Ltd.	`"GmbH"`	oftast: GmbH, UG, GmbH & Co. KG sällan: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Bara för organisationer: den aktuella statusen i registret.Tomt när innehavaren inte är matchad, samt alltid i de tidigare dokumenten i historyVärden: `ACTIVE` aktiv, `INACTIVE` inte längre aktiv, till exempel avregistrerad eller fusionerad	`"ACTIVE"`	som ovan
shareholders_deep.entries[].holder.citystring\|null	Säte eller bostadsort.	`"Gunzenhausen"`	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].holder.countrystring\|null	Land som trebokstavskod enligt ISO (ISO 3166-1 alpha-3), till exempel DEU, AUT eller LUX.	`"DEU"`	som ovan
shareholders_deep.entries[].holder.registrationobject\|null	Bara för organisationer: court, register_type och register_number.Tomt när ingen registeranteckning kan läsas, till exempel för många utländska företag	–	oftast: GmbH, UG, GmbH & Co. KG sällan: AG, SE, KGaA, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Bara för organisationer: registeranteckningen som text, när registration saknas eller inte nämner någon domstol.	`null`	sällan
shareholders_deep.entries[].rolestring	Innehavarens roll. Nya värden kan tillkomma.Värden: `SHAREHOLDER` delägare enligt delägarförteckningen eller stiftelsedokumentet, `LIMITED_PARTNER` kommanditdelägare (Kommanditist), `FULLY_LIABLE_PARTNER` personligt ansvarig bolagsman (persönlich haftender Gesellschafter), `PARTNER` partner i ett PartG, `OWNER` ägare till en e.K.	`"SHAREHOLDER"`	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].sincestring\|null	Sedan när innehavaren äger andelar. För registrerade bolagsmän datumet för registreringen.Tomt när inget datum kan fastställas, samt alltid för JOINT	`"2015-08-18"`	som ovan
shareholders_deep.entries[].since_basisstring\|null	Hur säkert since är.Värden: `ENTRY_RECORDED` belagt från detta datum: förteckningen innan nämner ännu inte innehavaren, `EARLIEST_RECORD` redan i det äldsta tillgängliga dokumentet, alltså delägare sedan åtminstone detta datum	`"ENTRY_RECORDED"`	som ovan

Andelen. ownership beskriver hur mycket en innehavare äger: i procent, som nominellt belopp och via andelarnas löpnummer.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholders_deep.entries[].ownershipobject	Innehavarens andel.`shareholders_deep` · från Max	–	oftast: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG sällan: AG, SE, KGaA aldrig: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Andel av kapitalet i procent, från 0 till 100. Det är det direkta delägarskapet, inte rösträtterna.Tomt när andelen inte kan fastställas tillförlitligt, samt alltid för registrerade bolagsmän i personbolag	`94.5`	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Var percentage kommer ifrån.Värden: `REPORTED` angivet i dokumentet eller härlett ur nominellt belopp och kapital i dokumentet, `CALCULATED` beräknat ur antal och nominellt belopp för andelarna	`"REPORTED"`	som ovan
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Summa av de nominella beloppen med value och currency. För kommanditdelägare det registrerade ansvarsbeloppet (Haftsumme).Tomt när inget belopp är känt	–	oftast: GmbH, UG, GmbH & Co. KG delvis: KG, OHG sällan: AG, SE, KGaA aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Antal andelar (Geschäftsanteile).Tomt när antalet inte är känt för alla andelar	`47250`	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Andelarna efter sina löpnummer i förteckningen, ett intervall per följd av likadana andelar.	–	som ovan
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Intervallets första löpnummer.	`1`	som ovan
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Intervallets sista löpnummer.	`47250`	som ovan
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Antal andelar i intervallet.	`47250`	som ovan
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Nominellt belopp per andel i intervallet, med value och currency.	–	som ovan

Historik och ändringar. history innehåller de tidigare dokumenten med samma fält. Innehavarna står där så som de stod i dokumentet vid den tiden. changes jämför det aktuella läget med det föregående.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholders_deep.historyarray	De tidigare dokumenten, de senaste först, vart och ett med record, share_capital och entries. Tidigare registrerade bolagsmän samlas i den sista posten.`shareholders_deep` · från Max	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	För JOINT: de gemensamma innehavarna av typen PERSON eller ORGANIZATION, med samma fält som holder.	–	sällan
shareholders_deep.history[].entries[].untilstring\|null	Bara i posten i history med COMMERCIAL_REGISTER: när bolagsmannen lämnade.	–	delvis: GmbH & Co. KG, KG, OHG, PartG sällan: e.K. aldrig: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Vad som ändrades med det aktuella dokumentet jämfört med det föregående.Tomt när det inte finns något tidigare dokument, samt när det aktuella läget kommer från registret eller ett stiftelsedokument	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Datum för det föregående dokumentet.	`"2015-07-16"`	som ovan
shareholders_deep.changes.joinedarray	Nya innehavare: holder med entity_id, type och name, plus percentage.	–	som ovan
shareholders_deep.changes.leftarray	Innehavare som har lämnat, med den andel de senast hade.	–	som ovan
shareholders_deep.changes.changedarray	Innehavare vars andel har ändrats.	–	som ovan
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Andel i procent i det föregående dokumentet.	`100`	som ovan
shareholders_deep.changes.changed[].percentage_afternumber\|null	Andel i procent i det aktuella dokumentet.	`5.5`	som ovan

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 · Exempelsvar: Hetzner Online GmbH med funktionen shareholders_deep

Jämfört med shareholders lägger shareholders_deep till andelsnumren, datumet sedan vilket någon äger andelar, ändringarna och gemensamt ägda andelar med deras medlemmar. För jämförelser över företag och år är det bäst att genomgående använda samma funktion.

Verkliga huvudmän

Verkliga huvudmän är de fysiska personer som i slutändan äger ett företag. Funktionen ubos följer delägarförteckningarna över ägarnivåerna ned till personerna. Listan nämner varje person med en beräknad andel, utan lägsta tröskel. Den kostar 10 krediter när den returnerar data.

Om en andel inte kan spåras till en person står den i unresolved_beneficial_owners med orsaken. Ofta innehas den av ett företag utomlands. Våra data omfattar tyska företag, så vi känner inte till delägarna i ett företag utomlands. coverage visar hur många procent av kapitalet som är spårade till personer och hur mycket som är öppet. De två värdena blir inte alltid 100 tillsammans. För resten nämner delägardatan ingen innehavare.

Funktionen debiteras så snart den returnerar ett resultat. Det gäller även när alla andelar står i unresolved_beneficial_owners.

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

Fält
Fält	Betydelse	Exempel	Tillgänglighet
ubosobject\|null	De verkliga huvudmännen, beräknade ur delägarförteckningarna över ägarnivåerna.Tomt när ingen kedja kan byggas ur delägarförteckningar, till exempel för AG, eG eller e.K`ubos` · Beta	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.beneficial_ownersarray	De personer som äger företaget direkt eller via andra företag.Tomt när ingen andel kan spåras till en person	–	som ovan
ubos.beneficial_owners[].personobject	Personen, med fälten nedan.	–	delvis: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	Personens ID, för personprofilen.Tomt när personen inte kunde matchas med säkerhet	–	som ovan
ubos.beneficial_owners[].person.namestring	Fullständigt namn.	–	som ovan
ubos.beneficial_owners[].person.name_partsobject	Namnet i delar: given och family, samt canonical_name när det är känt.	–	som ovan
ubos.beneficial_owners[].person.birth_datestring\|null	Födelsedatum.	–	som ovan
ubos.beneficial_owners[].person.locationobject\|null	Bostadsort i home: city, county, state och country.Tomt när ingen bostadsort är känd	–	som ovan
ubos.beneficial_owners[].ownership_percentagenumber	Personens totala andel i procent, summerad över alla vägar.	`50`	som ovan
ubos.beneficial_owners[].pathsarray	Varje väg till personen, med andelen längs den vägen.	–	som ovan
ubos.beneficial_owners[].paths[].percentagenumber	Andel i procent som kommer fram via denna väg.	`50`	som ovan
ubos.beneficial_owners[].paths[].viaarray	Företagen på denna väg, först den direkta delägaren i det begärda företaget (djup 1). Fälten är desamma som i via för de olösta andelarna.Tomt när personen äger andelar direkt	–	som ovan

Fält
Fält	Betydelse	Exempel	Tillgänglighet
ubos.unresolved_beneficial_ownersarray	Andelar som inte kunde spåras till en person.Tomt när alla andelar är lösta`ubos` · Beta	–	oftast: GmbH, UG sällan: AG, SE, KGaA, GmbH & Co. KG, KG, OHG aldrig: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Varför kedjan slutar här. Nya värden kan tillkomma.Värden: `unlinked` delägaren är ett företag som vi inte kan matcha mot en anteckning i det tyska registret, oftast ett företag utomlands. Vi känner inte till dess delägare, så kedjan slutar här, `no_further_shareholder_data` delägaren är ett tyskt företag som vi känner till, men det finns ingen delägarförteckning för det, till exempel ett KG, `cycle` kedjan leder tillbaka till ett företag som redan finns i den, till exempel när ett företag äger egna andelar, `unknown` ingenting är känt om delägaren, varken namn eller andel	`"cycle"`	som ovan
ubos.unresolved_beneficial_owners[].namestring\|null	Namn på den delägare där kedjan slutar.Tomt när orsaken är unknown	`"ENSoXX Holding AG"`	som ovan
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Dess ID, för dess egen företagsprofil.Tomt när delägaren inte är matchad mot ett företag i våra data, alltså för orsakerna unlinked och unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	som ovan
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Dess bolagsform.	`"AG"`	som ovan
ubos.unresolved_beneficial_owners[].addressobject\|array	Dess adress med street, house_number, postal_code, city, county, state, country och coordinates.Tomt när ingen adress är känd; värdet är då en tom lista []	–	som ovan
ubos.unresolved_beneficial_owners[].registrationobject\|array	Dess registeranteckning med court, register_type och register_number, även från utländska register.Tomt när ingen anteckning är känd; värdet är då en tom lista []	–	som ovan
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Den olösta andelen i procent, genomräknad till det begärda företaget. Den kan vara 0.	`0`	som ovan
ubos.unresolved_beneficial_owners[].viaarray	De företag som kedjan går genom fram hit, först den direkta delägaren i det begärda företaget.Tomt när den olösta andelen innehas direkt i det begärda företaget	–	som ovan
ubos.unresolved_beneficial_owners[].via[].depthinteger	Nivån: 1 är en direkt delägare i det begärda företaget. Bredvid står företagets name och entity_id.	`1`	som ovan
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Andel i procent på denna nivå.	`94.5`	som ovan
ubos.coverageobject	Hur mycket av kapitalet som är spårat till personer och hur mycket som är öppet. De två värdena blir inte alltid 100 tillsammans.	–	som ovan
ubos.coverage.resolved_percentagenumber	Spårat till personer, i procent.	`5.5`	som ovan
ubos.coverage.unresolved_percentagenumber	Inte spårat till personer, i procent.	`0`	som ovan

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 · Exempelsvar: Hetzner Online GmbH med funktionen ubos. I vår exempelförfrågan stod en person med 5,5 % i beneficial_owners. Kedjan genom ENSoXX GmbH, Ansbach HRB 6105, slutade i unresolved_beneficial_owners med orsakerna cycle och unknown.

Vi beräknar datan ur delägarförteckningarna. Uppgifter om verkliga huvudmän från Transparenzregister (det tyska registret över verkliga huvudmän) har inte varit offentligt tillgängliga sedan slutet av 2022.

Innehav

Funktionen shareholdings visar den andra riktningen: vilka företag det begärda företaget äger andelar i. Innehaven kommer från dessa företags delägarförteckningar. Den kostar 5 krediter när det finns innehav.

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

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholdingsobject\|null	De företag där det begärda företaget äger andelar.Tomt när inget innehav är känt`shareholdings` · Beta	–	oftast: AG, SE, KGaA delvis: GmbH, UG sällan: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	De nuvarande innehaven, ett per företag.	–	som ovan
shareholdings.holdings.current[].organizationobject	Det företag där andelarna innehas.	–	som ovan
shareholdings.holdings.current[].organization.entity_idstring	Företagets ID, för dess företagsprofil.	`"63529c3a793e9f002196b4fd344e1241"`	som ovan
shareholdings.holdings.current[].organization.namestring\|null	Företagets namn.	`"Hetzner Cloud GmbH"`	som ovan
shareholdings.holdings.current[].organization.legal_formstring\|null	Företagets bolagsform.	`"GmbH"`	som ovan
shareholdings.holdings.current[].organization.statusstring\|null	Företagets status i registret, till exempel ACTIVE.	`"ACTIVE"`	som ovan
shareholdings.holdings.current[].organization.addressobject\|array	Företagets adress, uppbyggd som address i grunddata.Tomt när ingen adress är känd; värdet är då en tom lista []	–	som ovan
shareholdings.holdings.current[].organization.registrationobject\|array	Företagets registeranteckning med court, register_type och register_number.Tomt när ingen anteckning är känd; värdet är då en tom lista []	–	som ovan
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel i procent: 100 betyder 100 %.Tomt när förteckningen inte ger någon andel	`100`	som ovan
shareholdings.holdings.current[].ownership.contributionobject	Andelarnas nominella belopp med amount och currency.	–	som ovan
shareholdings.holdings.current[].as_ofstring	Datum för den delägarförteckning som innehavet kommer från.	`"2017-09-19"`	som ovan
shareholdings.summary.total_currentinteger	Antal nuvarande innehav.	`2`	som ovan

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 · Exempelsvar: Hetzner Online GmbH med funktionen shareholdings

En persons innehav finns i personprofilen, med samma funktion.

Koncernstrukturer

Koncernkopplingar sätter du ihop av flera datapunkter. shareholders och shareholdings visar delägarskapen en nivå upp och ned, ubos personerna i slutet av kedjan.

Företagsnätverket kopplar ihop företag och personer över två nivåer. Det omfattar även koncernbolag.

Fusioner, delningar och andra ombildningar finns under Fusioner & förvärv.