Tagok és részesedések – Dokumentáció

Funkció
Funkció	Mit ad vissza	Kredit	Elérhető
shareholders	Tagok: a jelenlegi tagok a részesedéseikkel és a korábbi tagjegyzékek	5	minden fiók · Béta
shareholders_deep	Részletes tagadatok: tulajdonosok az üzletrészek sorszámaival, hogy mióta tartanak részesedést, és mi változott legutóbb	80	Max
ubos	Tényleges tulajdonosok (UBO): a cég mögött álló személyek, a tagjegyzékekből számítva	10	minden fiók · Béta
shareholdings	Részesedések: cégek, amelyekben magának a cégnek részesedése van	5	minden fiók · Béta

Tagok jogi formánként

Hogy a nyilvántartás mit mond a tulajdonosokról, az a jogi formától függ. A táblázat mutatja, mit kapsz jellemzően.

Jogi forma
Jogi forma	Tagok a válaszban
GmbH, UG	Az összes tag a § 40 GmbHG szerinti tagjegyzékből, névértékkel és a törzstőkéből (Stammkapital) való részesedéssel, plusz a korábbi listák.
AG, SE, KGaA	Csak egyes esetekben, mert egy AG részvényesei nem szerepelnek nyilvános nyilvántartásban.
GmbH & Co. KG	A kültagok (Kommanditisten) a nyilvántartásból a felelősségi összegükkel, részben a beltag GmbH is.
KG, OHG	A bejegyzett tagok: KG-nál a beltagok (Komplementäre) és a kültagok, OHG-nál a korlátlanul felelős tagok.
e.K.	A tulajdonos.
eG	Nincsenek. Egy szövetkezet taglistája nem nyilvános.
PartG	A bejegyzett partnerek.

A tagjegyzékek gyakran sokféle elrendezésű szkennelt dokumentumok. Automatikusan nyerjük ki őket. Ehhez a legújabb technológiát használjuk, és sokat fektetünk a minőségbe; egyes hibák ennek ellenére előfordulhatnak.

Tagok

A shareholders funkció a jelenlegi tagokat adja vissza: GmbH-nál a legújabb tagjegyzékből, személyegyesítő társaságoknál és egyéni kereskedőknél a nyilvántartásból. 5 kredit kerül, de csak ha jelenlegi tagokat nevez meg. Ha csak korábbi listákat ad vissza, nem kerül semmibe.

Az entries minden bejegyzése egy személyt vagy egy céget ír le. Egy személynek first_name, last_name és birth_date, egy cégnek entity_name, country_code és registration_reference mezője van.

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

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholdersobject\|null	A cég tagjai: aktuális állapot az entries, korábbi állapotok a history alatt.Üres, ha nem ismertek tagok, például AG-nál vagy eG-nél`shareholders` · Béta	–	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders.entriesarray	A jelenlegi tagok, személyenként vagy cégenként egy bejegyzés.	–	mint fent
shareholders.entries[].shareholderobject	Ki tartja a részesedést: egy személy vagy egy cég, az alábbi mezőkkel.	–	mint fent
shareholders.entries[].shareholder.entity_idstring\|null	A személy vagy a cég azonosítója, a saját személyprofiljához vagy cégprofiljához.Üres, ha a tagot nem sikerült biztosan párosítani	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	mint fent
shareholders.entries[].shareholder.first_namestring	Egy személy utóneve, az összes bejegyzett utónévvel.	–	mindig: e.K. többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG ritkán: AG, SE, KGaA soha: eG
shareholders.entries[].shareholder.last_namestring	Egy személy családneve.	–	mint fent
shareholders.entries[].shareholder.birth_datestring\|null	Egy személy születési dátuma YYYY-MM-DD formátumban.Üres, ha a dokumentum nem ad meg születési dátumot	–	mint fent
shareholders.entries[].shareholder.entity_namestring	Egy tagként szereplő cég neve.	`"ENSoXX GmbH"`	többnyire: GmbH, UG, GmbH & Co. KG ritkán: AG, SE, KGaA, KG, OHG soha: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Egy cég országa háromjegyű ISO-kódként (ISO 3166-1 alpha-3), például DEU.	`"DEU"`	mint fent
shareholders.entries[].shareholder.registration_referencestring\|null	Egy cég nyilvántartási bejegyzése szövegként, ahogy a dokumentumban szerepel.Üres, ha a dokumentum nem ad meg nyilvántartási bejegyzést, gyakran külföldi cégeknél	`"AG Ansbach HRB 6105"`	mint fent
shareholders.entries[].shareholder.addressstring\|null	Cím, lakóhely vagy székhely szövegként, ahogy a dokumentumban szerepel.Üres, ha a dokumentum nem ad meg címet	`"Gunzenhausen"`	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders.entries[].contributionobject\|null	A részesedés összege amount és currency mezővel: GmbH-nál az üzletrészek névértéke, kültagoknál a bejegyzett felelősségi összeg (Haftsumme).Üres, ha nincs bejegyzett összeg, például a korlátlanul felelős tagoknál vagy egy e.K. tulajdonosánál	–	többnyire: GmbH, UG, GmbH & Co. KG részben: KG, OHG ritkán: AG, SE, KGaA soha: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	A tőkéből való részesedés tizedes törtként: az 1 100%-ot, a 0.245 24,5%-ot jelent.Üres, ha nem vezethető le részesedés, például személyegyesítő társaságoknál	`0.945`	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders.entries[].roleobject	A szerep: label rögzített kódként, plusz de és en hosszú és rövid névvel, például Kommanditist és Kom.	–	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders.entries[].role.labelstring	A szerep rögzített kódként. Új értékek jöhetnek.Értékek: `SHAREHOLDER` tag a tagjegyzék szerint, `LIMITED_PARTNER` kültag (Kommanditist), `FULLY_LIABLE_PARTNER` korlátlanul felelős tag (persönlich haftender Gesellschafter), `PARTNER` egy PartG partnere, `OWNER` egy e.K. tulajdonosa	`"SHAREHOLDER"`	mint fent
shareholders.total_capitalobject\|null	A tagjegyzék szerinti tőke amount és currency mezővel, a contribution_ratio alapja.Üres, ha a lista nem ad meg tőkét, valamint személyegyesítő társaságoknál	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG

Egy tag entity_id-jával lekéred a saját cégprofilját vagy személyprofilját. Így szintről szintre követsz egy tulajdonosi láncot.

A tagok előzményei

A shareholders.history felár nélkül érkezik. Tartalmazza a jelenlegi lista dátumát és a korábbi tagjegyzékeket, a legújabbal kezdve.

KG-nál vagy GmbH & Co. KG-nál a korábbi tagok a register_ownership alatt vannak, a nyilvántartás szerinti be- és kilépési dátummal. OHG-nál, PartG-nél és e.K.-nál a shareholders_deep alatt találod őket.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholders.historyobject	A tagok korábbi állapotai, felár nélkül.Üres, ha nincsenek korábbi állapotok; a mező ilyenkor hiányzik, például OHG-nál, PartG-nél vagy e.K.-nál`shareholders` · Béta	–	többnyire: GmbH, UG részben: GmbH & Co. KG, KG, OHG ritkán: AG, SE, KGaA soha: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Annak a tagjegyzéknek a dátuma, amelyből az entries származik.Üres, ha a tagok a nyilvántartásból származnak	`"2015-08-21"`	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders.history.pastarray	Korábbi tagjegyzékek, a legújabbal kezdve.Üres, ha csak egy lista létezik	–	mint fent
shareholders.history.past[].as_ofstring	Ennek a tagjegyzéknek a dátuma.	`"2015-07-28"`	mint fent
shareholders.history.past[].data.total_capitalobject\|null	A lista szerinti tőke amount és currency mezővel. A régebbi listák részben DEM-ben adják meg.	–	mint fent
shareholders.history.past[].data.shareholdersarray	A lista szerinti tagok, ugyanazokkal a mezőkkel, mint az entries.	–	mint fent
shareholders.history.register_ownershipobject	KG-nál és GmbH & Co. KG-nál: a korábbi tagok a nyilvántartás szerint, a past alatt.	–	részben: GmbH & Co. KG, KG, OHG soha: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	A korábbi tag, ugyanazokkal a mezőkkel, mint az entries alatt.	–	mint fent
shareholders.history.register_ownership.past[].roleobject	A szerepe, az entries role mezőjéhez hasonló felépítésben.	–	mint fent
shareholders.history.register_ownership.past[].effective_fromstring\|null	Mióta volt bejegyezve, YYYY-MM-DD formátumban.	`"2022-01-07"`	mint fent
shareholders.history.register_ownership.past[].effective_tostring\|null	Meddig volt bejegyezve.	`"2026-07-06"`	mint fent
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true, ha az effective_to levezetett, és nem kifejezetten bejegyzett.	`false`	mint fent
shareholders.history.register_ownership.past[].contributionnull	Itt mindig null.	–	mint fent
shareholders.history.register_ownership.past[].contribution_rationull	Itt mindig null.	–	mint fent

Részletes tagadatok

A shareholders_deep funkció a Max csomaggal érhető el. 80 kredit kerül, de csak ha az aktuális dokumentum legalább egy tulajdonost megnevez.

Egy cég összes tagjegyzékét beolvassa, nem csak a legújabbat. Így megmutatja, mióta tart valaki részesedést, hogyan néztek ki a korábbi állapotok, és mit változtatott az utolsó lista.

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

A dokumentum. A record megmondja, honnan származik az aktuális állapot, a share_capital a dokumentum szerinti tőkét adja meg.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholders_deepobject\|null	Tulajdonosok, részesedések, korábbi dokumentumok és az utolsó változás.Üres, ha nem ismert aktuális dokumentum és bejegyzett tag, jellemzően AG-nál, SE-nél és eG-nél`shareholders_deep` · Max csomagtól	–	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.recordobject	A dokumentum, amelyből az aktuális állapot származik: dátum és forrás.	–	mint fent
shareholders_deep.record.datestring\|null	A dátum, amelyre a dokumentum vonatkozik. Általában röviddel a dokumentum által mutatott változás utáni.Üres, ha a tagok a nyilvántartásból származnak (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.record.sourcestring	A dokumentum fajtája.Értékek: `SHAREHOLDER_LIST` tagjegyzék (Gesellschafterliste), `FOUNDING_DOCUMENT` alapító okirat, azaz Musterprotokoll (mintajegyzőkönyv) vagy Gesellschaftsvertrag (társasági szerződés), `COMMERCIAL_REGISTER` a nyilvántartásba bejegyzett tagok vagy tulajdonosok	`"SHAREHOLDER_LIST"`	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.share_capitalobject\|null	A dokumentum szerinti tőke: érték, pénznem és alap.Üres, ha a dokumentum nem ad meg tőkét, valamint mindig COMMERCIAL_REGISTER esetén	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Honnan származik az összeg.Értékek: `REPORTED` a dokumentumban megadva, `CALCULATED` az üzletrészek számából és névértékéből számítva	`"REPORTED"`	mint fent

A tulajdonosok. Az entries minden bejegyzése a dokumentum egy sora, a legnagyobb részesedéssel kezdve. Ha valakinek több sora van, többször szerepel a listában.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholders_deep.entriesarray	A jelenlegi tulajdonosok, bejegyzésenként a dokumentum egy sora, a legnagyobb részesedéssel kezdve.`shareholders_deep` · Max csomagtól	–	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.entries[].holderobject	Ki tartja a részesedést. A type határozza meg, milyen mezők következnek.	–	mint fent
shareholders_deep.entries[].holder.typestring	A tulajdonos fajtája.Értékek: `ORGANIZATION` cég vagy más szervezet, `PERSON` természetes személy, `JOINT` közösen tartott részesedés, például egy örökösközösségé, members mezővel	`"ORGANIZATION"`	mint fent
shareholders_deep.entries[].holder.entity_idstring\|null	A tulajdonos azonosítója, a saját cégprofiljához vagy személyprofiljához.Üres, ha a tulajdonost nem sikerült biztosan párosítani, valamint mindig JOINT esetén	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	mint fent
shareholders_deep.entries[].holder.namestring	A név. Párosított tulajdonosoknál a jelenlegi név, különben ahogy a dokumentumban áll.	`"ENSoXX GmbH"`	mint fent
shareholders_deep.entries[].holder.birth_datestring\|null	Csak személyeknél: a születési dátum.Üres, ha a dokumentum nem ad meg ilyet	–	mindig: e.K. többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Csak szervezeteknél: a jogi forma szövegként, például GmbH vagy Ltd.	`"GmbH"`	többnyire: GmbH, UG, GmbH & Co. KG ritkán: AG, SE, KGaA, KG, OHG soha: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Csak szervezeteknél: a jelenlegi státusz a nyilvántartásban.Üres, ha a tulajdonos nincs párosítva, valamint mindig a history korábbi dokumentumaibanÉrtékek: `ACTIVE` aktív, `INACTIVE` már nem aktív, például törölt vagy beolvadt	`"ACTIVE"`	mint fent
shareholders_deep.entries[].holder.citystring\|null	Székhely vagy lakóhely.	`"Gunzenhausen"`	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.entries[].holder.countrystring\|null	Ország háromjegyű ISO-kódként (ISO 3166-1 alpha-3), például DEU, AUT vagy LUX.	`"DEU"`	mint fent
shareholders_deep.entries[].holder.registrationobject\|null	Csak szervezeteknél: court, register_type és register_number.Üres, ha nem olvasható ki nyilvántartási bejegyzés, például sok külföldi cégnél	–	többnyire: GmbH, UG, GmbH & Co. KG ritkán: AG, SE, KGaA, KG, OHG soha: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Csak szervezeteknél: a nyilvántartási bejegyzés szövegként, ha a registration hiányzik, vagy nem nevez meg bíróságot.	`null`	ritkán
shareholders_deep.entries[].rolestring	A tulajdonos szerepe. Új értékek jöhetnek.Értékek: `SHAREHOLDER` tag a tagjegyzék vagy az alapító okirat szerint, `LIMITED_PARTNER` kültag (Kommanditist), `FULLY_LIABLE_PARTNER` korlátlanul felelős tag (persönlich haftender Gesellschafter), `PARTNER` egy PartG partnere, `OWNER` egy e.K. tulajdonosa	`"SHAREHOLDER"`	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.entries[].sincestring\|null	Mióta tart a tulajdonos részesedést. Bejegyzett tagoknál a bejegyzés dátuma.Üres, ha nem határozható meg dátum, valamint mindig JOINT esetén	`"2015-08-18"`	mint fent
shareholders_deep.entries[].since_basisstring\|null	Mennyire biztos a since.Értékek: `ENTRY_RECORDED` ettől a dátumtól dokumentált: az előző lista még nem nevezi meg a tulajdonost, `EARLIEST_RECORD` már a legrégebbi elérhető dokumentumban szerepel, tehát legalább ettől a dátumtól tag	`"ENTRY_RECORDED"`	mint fent

A részesedés. Az ownership leírja, mennyit tart egy tulajdonos: százalékban, névértékként és az üzletrészek sorszámai szerint.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholders_deep.entries[].ownershipobject	A tulajdonos részesedése.`shareholders_deep` · Max csomagtól	–	többnyire: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG ritkán: AG, SE, KGaA soha: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	A tőkéből való részesedés százalékban, 0 és 100 között. Ez a közvetlen részesedés, nem a szavazati jog.Üres, ha a részesedés nem határozható meg megbízhatóan, valamint mindig a személyegyesítő társaságok bejegyzett tagjainál	`94.5`	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Honnan származik a percentage.Értékek: `REPORTED` a dokumentumban megadva, vagy a dokumentumban szereplő névértékből és tőkéből levezetve, `CALCULATED` az üzletrészek számából és névértékéből számítva	`"REPORTED"`	mint fent
shareholders_deep.entries[].ownership.nominal_amountobject\|null	A névértékek összege value és currency mezővel. Kültagoknál a bejegyzett felelősségi összeg (Haftsumme).Üres, ha nem ismert összeg	–	többnyire: GmbH, UG, GmbH & Co. KG részben: KG, OHG ritkán: AG, SE, KGaA soha: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Az üzletrészek (Geschäftsanteile) száma.Üres, ha a szám nem minden üzletrésznél ismert	`47250`	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Az üzletrészek a listában szereplő sorszámaik szerint, azonos üzletrészek sorozatonként egy tartomány.	–	mint fent
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	A tartomány első sorszáma.	`1`	mint fent
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	A tartomány utolsó sorszáma.	`47250`	mint fent
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Az üzletrészek száma a tartományban.	`47250`	mint fent
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Üzletrészenkénti névérték a tartományban, value és currency mezővel.	–	mint fent

Előzmények és változások. A history a korábbi dokumentumokat tartalmazza ugyanazokkal a mezőkkel. A tulajdonosok ott úgy szerepelnek, ahogy az akkori dokumentumban álltak. A changes az aktuális állapotot hasonlítja össze az előzővel.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholders_deep.historyarray	A korábbi dokumentumok, a legújabbal kezdve, mindegyik record, share_capital és entries mezővel. A korábbi bejegyzett tagok az utolsó bejegyzésben vannak összegyűjtve.`shareholders_deep` · Max csomagtól	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	JOINT esetén: a PERSON vagy ORGANIZATION típusú közös tulajdonosok, ugyanazokkal a mezőkkel, mint a holder.	–	ritkán
shareholders_deep.history[].entries[].untilstring\|null	Csak a history COMMERCIAL_REGISTER forrású elemében: mikor lépett ki a tag.	–	részben: GmbH & Co. KG, KG, OHG, PartG ritkán: e.K. soha: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Mi változott az aktuális dokumentummal az előzőhöz képest.Üres, ha nincs korábbi dokumentum, valamint ha az aktuális állapot a nyilvántartásból vagy egy alapító okiratból származik	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Az előző dokumentum dátuma.	`"2015-07-16"`	mint fent
shareholders_deep.changes.joinedarray	Új tulajdonosok: holder entity_id, type és name mezővel, plusz percentage.	–	mint fent
shareholders_deep.changes.leftarray	Kilépett tulajdonosok, az utoljára birtokolt részesedésükkel.	–	mint fent
shareholders_deep.changes.changedarray	Tulajdonosok, akiknek a részesedése megváltozott.	–	mint fent
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Részesedés százalékban az előző dokumentumban.	`100`	mint fent
shareholders_deep.changes.changed[].percentage_afternumber\|null	Részesedés százalékban az aktuális dokumentumban.	`5.5`	mint fent

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 · Példaválasz: a Hetzner Online GmbH a shareholders_deep funkcióval

A shareholders funkcióhoz képest a shareholders_deep hozzáadja az üzletrészek sorszámait, a dátumot, amióta valaki részesedést tart, a változásokat és a közösen tartott részesedéseket a tagjaikkal. Cégek és évek közötti összehasonlításhoz a legjobb végig ugyanazt a funkciót használni.

Tényleges tulajdonosok

A tényleges tulajdonosok azok a természetes személyek, akiké végső soron egy cég. Az ubos funkció a tagjegyzékeket követi a tulajdonosi szinteken át a személyekig. A lista minden személyt számított részesedéssel nevez meg, minimális küszöb nélkül. 10 kredit kerül, ha adatot ad vissza.

Ha egy részesedés nem vezethető vissza személyig, okkal együtt az unresolved_beneficial_owners alatt szerepel. Gyakran egy külföldi cég tartja. Adataink német cégeket fednek le, ezért egy külföldi cég tagjait nem ismerjük. A coverage mutatja, a tőke hány százaléka vezethető vissza személyekig, és mennyi marad nyitva. A két érték nem mindig ad ki 100-at. A maradékhoz a tagi adatok nem neveznek meg tulajdonost.

A funkciót felszámoljuk, amint eredményt ad vissza. Ez akkor is érvényes, ha minden részesedés az unresolved_beneficial_owners alatt van.

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

Mező
Mező	Jelentés	Példa	Elérhetőség
ubosobject\|null	A tényleges tulajdonosok, a tagjegyzékekből számítva a tulajdonosi szinteken át.Üres, ha a tagjegyzékekből nem építhető lánc, például AG-nál, eG-nél vagy e.K.-nál`ubos` · Béta	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
ubos.beneficial_ownersarray	A személyek, akiké a cég közvetlenül vagy más cégeken keresztül.Üres, ha egyetlen részesedés sem vezethető vissza személyig	–	mint fent
ubos.beneficial_owners[].personobject	A személy, az alábbi mezőkkel.	–	részben: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	A személy azonosítója, a személyprofilhoz.Üres, ha a személyt nem sikerült biztosan párosítani	–	mint fent
ubos.beneficial_owners[].person.namestring	Teljes név.	–	mint fent
ubos.beneficial_owners[].person.name_partsobject	A név részekre bontva: given és family, és canonical_name, ha ismert.	–	mint fent
ubos.beneficial_owners[].person.birth_datestring\|null	Születési dátum.	–	mint fent
ubos.beneficial_owners[].person.locationobject\|null	Lakóhely a home alatt: city, county, state és country.Üres, ha nem ismert lakóhely	–	mint fent
ubos.beneficial_owners[].ownership_percentagenumber	A személy teljes részesedése százalékban, az összes útvonalon összeadva.	`50`	mint fent
ubos.beneficial_owners[].pathsarray	Minden útvonal a személyig, az útvonal menti részesedéssel.	–	mint fent
ubos.beneficial_owners[].paths[].percentagenumber	Az ezen az útvonalon érkező részesedés százalékban.	`50`	mint fent
ubos.beneficial_owners[].paths[].viaarray	A cégek ezen az útvonalon, elsőként a lekért cég közvetlen tagja (1. mélység). A mezők ugyanazok, mint a feloldatlan részesedések via mezőjében.Üres, ha a személy közvetlenül tart részesedést	–	mint fent

Mező
Mező	Jelentés	Példa	Elérhetőség
ubos.unresolved_beneficial_ownersarray	Részesedések, amelyeket nem sikerült személyig visszavezetni.Üres, ha minden részesedés fel van oldva`ubos` · Béta	–	többnyire: GmbH, UG ritkán: AG, SE, KGaA, GmbH & Co. KG, KG, OHG soha: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Miért ér itt véget a lánc. Új értékek jöhetnek.Értékek: `unlinked` a tag egy olyan cég, amelyet nem tudunk a német nyilvántartás egyik bejegyzéséhez párosítani, általában külföldi cég. A tagjait nem ismerjük, ezért a lánc itt véget ér, `no_further_shareholder_data` a tag egy általunk ismert német cég, de nincs hozzá tagjegyzék, például egy KG, `cycle` a lánc visszavezet egy olyan céghez, amely már szerepel benne, például ha egy cég a saját üzletrészeit tartja, `unknown` a tagról semmit nem tudunk, sem a nevét, sem a részesedését	`"cycle"`	mint fent
ubos.unresolved_beneficial_owners[].namestring\|null	Annak a tagnak a neve, ahol a lánc véget ér.Üres, ha az ok unknown	`"ENSoXX Holding AG"`	mint fent
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Az azonosítója, a saját cégprofiljához.Üres, ha a tag nincs párosítva egy céggel az adatainkban, azaz unlinked és unknown okoknál	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	mint fent
ubos.unresolved_beneficial_owners[].legal_formstring\|null	A jogi formája.	`"AG"`	mint fent
ubos.unresolved_beneficial_owners[].addressobject\|array	A címe street, house_number, postal_code, city, county, state, country és coordinates mezővel.Üres, ha nem ismert cím; az érték ilyenkor üres lista []	–	mint fent
ubos.unresolved_beneficial_owners[].registrationobject\|array	A nyilvántartási bejegyzése court, register_type és register_number mezővel, külföldi nyilvántartásokból is.Üres, ha nem ismert bejegyzés; az érték ilyenkor üres lista []	–	mint fent
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	A feloldatlan részesedés százalékban, a lekért cégig végigszámítva. Lehet 0 is.	`0`	mint fent
ubos.unresolved_beneficial_owners[].viaarray	A cégek, amelyeken a lánc idáig fut, elsőként a lekért cég közvetlen tagja.Üres, ha a feloldatlan részesedést közvetlenül a lekért cégben tartják	–	mint fent
ubos.unresolved_beneficial_owners[].via[].depthinteger	A szint: az 1 a lekért cég közvetlen tagja. Mellette áll a cég neve és entity_id-ja.	`1`	mint fent
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Részesedés százalékban ezen a szinten.	`94.5`	mint fent
ubos.coverageobject	A tőke mekkora része vezethető vissza személyekig, és mennyi marad nyitva. A két érték nem mindig ad ki 100-at.	–	mint fent
ubos.coverage.resolved_percentagenumber	Személyekig visszavezetve, százalékban.	`5.5`	mint fent
ubos.coverage.unresolved_percentagenumber	Személyekig vissza nem vezetve, százalékban.	`0`	mint fent

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 · Példaválasz: a Hetzner Online GmbH az ubos funkcióval. A példakérésünkben egy személy 5,5%-kal a beneficial_owners alatt volt. Az ENSoXX GmbH-n (Ansbach HRB 6105) át vezető lánc cycle és unknown okkal az unresolved_beneficial_owners alatt ért véget.

Az adatokat a tagjegyzékekből számítjuk. A Transparenzregister (átláthatósági nyilvántartás) tényleges tulajdonosokra vonatkozó adatai 2022 vége óta nem nyilvánosan hozzáférhetők.

Részesedések

A shareholdings funkció a másik irányt mutatja: mely cégekben van részesedése a lekért cégnek. A részesedések ezeknek a cégeknek a tagjegyzékeiből származnak. 5 kredit kerül, ha vannak részesedések.

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

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholdingsobject\|null	A cégek, amelyekben a lekért cégnek részesedése van.Üres, ha nem ismert részesedés`shareholdings` · Béta	–	többnyire: AG, SE, KGaA részben: GmbH, UG ritkán: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	A jelenlegi részesedések, cégenként egy.	–	mint fent
shareholdings.holdings.current[].organizationobject	A cég, amelyben a részesedést tartják.	–	mint fent
shareholdings.holdings.current[].organization.entity_idstring	A cég azonosítója, a cégprofiljához.	`"63529c3a793e9f002196b4fd344e1241"`	mint fent
shareholdings.holdings.current[].organization.namestring\|null	A cég neve.	`"Hetzner Cloud GmbH"`	mint fent
shareholdings.holdings.current[].organization.legal_formstring\|null	A cég jogi formája.	`"GmbH"`	mint fent
shareholdings.holdings.current[].organization.statusstring\|null	A cég státusza a nyilvántartásban, például ACTIVE.	`"ACTIVE"`	mint fent
shareholdings.holdings.current[].organization.addressobject\|array	A cég címe, az alapadatok address mezőjéhez hasonló felépítésben.Üres, ha nem ismert cím; az érték ilyenkor üres lista []	–	mint fent
shareholdings.holdings.current[].organization.registrationobject\|array	A cég nyilvántartási bejegyzése court, register_type és register_number mezővel.Üres, ha nem ismert bejegyzés; az érték ilyenkor üres lista []	–	mint fent
shareholdings.holdings.current[].ownership.percentagenumber\|null	Részesedés százalékban: a 100 100%-ot jelent.Üres, ha a listából nem adódik részesedés	`100`	mint fent
shareholdings.holdings.current[].ownership.contributionobject	Az üzletrészek névértéke amount és currency mezővel.	–	mint fent
shareholdings.holdings.current[].as_ofstring	Annak a tagjegyzéknek a dátuma, amelyből a részesedés származik.	`"2017-09-19"`	mint fent
shareholdings.summary.total_currentinteger	A jelenlegi részesedések száma.	`2`	mint fent

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 · Példaválasz: a Hetzner Online GmbH a shareholdings funkcióval

Egy személy részesedései a személyprofilban vannak, ugyanezzel a funkcióval.

Cégcsoport-struktúrák

A cégcsoport-kapcsolatokat több adatpontból állítod össze. A shareholders és a shareholdings egy szinttel felfelé és lefelé mutatja a részesedéseket, az ubos a lánc végén álló személyeket.

A Céghálózat két szinten át köti össze a cégeket és a személyeket. A kapcsolt vállalkozásokat is tartalmazza.

Az egyesülések, szétválások és más átalakulások az Egyesülések és felvásárlások alatt találhatók.