Osakkaat ja omistukset – Dokumentaatio

Ominaisuus
Ominaisuus	Mitä se palauttaa	Krediitit	Saatavilla
shareholders	Osakkaat: nykyiset osakkaat osuuksineen ja aiemmat osakasluettelot	5	kaikilla tileillä · Beta
shareholders_deep	Syvät osakastiedot: haltijat osuusnumeroineen, mistä lähtien he ovat omistaneet osuuksia ja mikä muuttui viimeksi	80	Max
ubos	Tosiasialliset edunsaajat (UBO): yrityksen takana olevat henkilöt osakasluetteloista laskettuina	10	kaikilla tileillä · Beta
shareholdings	Omistukset: yritykset, joissa yrityksellä itsellään on osuuksia	5	kaikilla tileillä · Beta

Osakkaat yhtiömuodoittain

Se, mitä rekisteri kertoo omistajista, riippuu yhtiömuodosta. Taulukko näyttää, mitä tyypillisesti saat.

Yhtiömuoto
Yhtiömuoto	Osakkaat vastauksessa
GmbH, UG	Kaikki osakkaat GmbHG:n 40 §:n mukaisesta osakasluettelosta nimellismäärineen ja osuuksineen Stammkapitalista (osakepääoma), lisäksi aiemmat luettelot.
AG, SE, KGaA	Vain yksittäistapauksissa, koska AG:n osakkeenomistajat eivät ole missään julkisessa rekisterissä.
GmbH & Co. KG	Rekisterin Kommanditistit (äänettömät yhtiömiehet) vastuusummineen, osin myös vastuunalainen GmbH-yhtiömies.
KG, OHG	Rekisteröidyt yhtiömiehet: KG:ssä Komplementärit (vastuunalaiset yhtiömiehet) ja äänettömät yhtiömiehet, OHG:ssä henkilökohtaisesti vastuunalaiset yhtiömiehet.
e.K.	Omistaja.
eG	Ei mitään. Osuuskunnan jäsenluettelo ei ole julkinen.
PartG	Rekisteröidyt partnerit.

Osakasluettelot ovat usein skannattuja asiakirjoja monessa eri asettelussa. Poimimme ne automaattisesti. Käytämme siihen uusinta tekniikkaa ja panostamme paljon laatuun; yksittäiset virheet ovat silti mahdollisia.

Osakkaat

Ominaisuus shareholders palauttaa nykyiset osakkaat: GmbH:lla uusimmasta osakasluettelosta, henkilöyhtiöillä ja elinkeinonharjoittajilla rekisteristä. Se maksaa 5 krediittiä, mutta vain jos se nimeää nykyisiä osakkaita. Jos se palauttaa vain aiempia luetteloita, se ei maksa mitään.

Jokainen entries-merkintä kuvaa henkilöä tai yritystä. Henkilöllä on first_name, last_name ja birth_date, yrityksellä entity_name, country_code ja registration_reference.

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

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholdersobject\|null	Yrityksen osakkaat: nykyinen tilanne kentässä entries, aiemmat tilanteet kentässä history.Tyhjä, kun osakkaita ei tunneta, esimerkiksi AG:llä tai eG:llä`shareholders` · Beta	–	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders.entriesarray	Nykyiset osakkaat, yksi merkintä henkilöä tai yritystä kohden.	–	kuten yllä
shareholders.entries[].shareholderobject	Kuka osuuden omistaa: henkilö tai yritys alla olevin kentin.	–	kuten yllä
shareholders.entries[].shareholder.entity_idstring\|null	Henkilön tai yrityksen tunniste sen omaa henkilöprofiilia tai yritysprofiilia varten.Tyhjä, kun osakasta ei voitu yhdistää varmasti	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	kuten yllä
shareholders.entries[].shareholder.first_namestring	Henkilön etunimi kaikkine rekisteröityine etunimineen.	–	aina: e.K. yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders.entries[].shareholder.last_namestring	Henkilön sukunimi.	–	kuten yllä
shareholders.entries[].shareholder.birth_datestring\|null	Henkilön syntymäaika muodossa YYYY-MM-DD.Tyhjä, kun asiakirjassa ei ole syntymäaikaa	–	kuten yllä
shareholders.entries[].shareholder.entity_namestring	Osakkaana olevan yrityksen nimi.	`"ENSoXX GmbH"`	yleensä: GmbH, UG, GmbH & Co. KG harvoin: AG, SE, KGaA, KG, OHG ei koskaan: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Yrityksen maa kolmikirjaimisena ISO-koodina (ISO 3166-1 alpha-3), esimerkiksi DEU.	`"DEU"`	kuten yllä
shareholders.entries[].shareholder.registration_referencestring\|null	Yrityksen rekisterimerkintä tekstinä sellaisena kuin se on asiakirjassa.Tyhjä, kun asiakirjassa ei ole rekisterimerkintää, usein ulkomaisilla yrityksillä	`"AG Ansbach HRB 6105"`	kuten yllä
shareholders.entries[].shareholder.addressstring\|null	Osoite, asuinpaikka tai kotipaikka tekstinä sellaisena kuin se on asiakirjassa.Tyhjä, kun asiakirjassa ei ole osoitetta	`"Gunzenhausen"`	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders.entries[].contributionobject\|null	Omistuksen määrä summineen ja valuuttoineen: GmbH:lla osuuksien nimellismäärä, äänettömillä yhtiömiehillä rekisteröity vastuusumma (Haftsumme).Tyhjä, kun summaa ei ole rekisteröity, esimerkiksi henkilökohtaisesti vastuunalaisilla yhtiömiehillä tai e.K:n omistajalla	–	yleensä: GmbH, UG, GmbH & Co. KG osittain: KG, OHG harvoin: AG, SE, KGaA ei koskaan: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Osuus pääomasta desimaalilukuna: 1 tarkoittaa 100 %, 0.245 tarkoittaa 24,5 %.Tyhjä, kun osuutta ei voida johtaa, esimerkiksi henkilöyhtiöillä	`0.945`	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders.entries[].roleobject	Rooli: label kiinteänä koodina sekä de ja en pitkällä ja lyhyellä nimellä, esimerkiksi Kommanditist ja Kom.	–	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders.entries[].role.labelstring	Rooli kiinteänä koodina. Uusia arvoja voi tulla lisää.Arvot: `SHAREHOLDER` osakas osakasluettelon mukaan, `LIMITED_PARTNER` äänetön yhtiömies (Kommanditist), `FULLY_LIABLE_PARTNER` henkilökohtaisesti vastuunalainen yhtiömies (persönlich haftender Gesellschafter), `PARTNER` PartG:n partneri, `OWNER` e.K.:n omistaja	`"SHAREHOLDER"`	kuten yllä
shareholders.total_capitalobject\|null	Pääoma osakasluettelon mukaan summineen ja valuuttoineen, contribution_ratio-kentän perusta.Tyhjä, kun luettelossa ei ole pääomaa, sekä henkilöyhtiöillä	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG

Osakkaan entity_id:llä haet sen oman yritysprofiilin tai henkilöprofiilin. Näin seuraat omistusketjua taso tasolta.

Osakashistoria

shareholders.history tulee ilman lisämaksua. Siinä on nykyisen luettelon päivämäärä ja aiemmat osakasluettelot uusimmasta alkaen.

KG:llä ja GmbH & Co. KG:llä entiset yhtiömiehet ovat kentässä register_ownership rekisterin liittymis- ja eroamispäivineen. OHG:n, PartG:n ja e.K.:n osalta löydät ne kentästä shareholders_deep.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholders.historyobject	Osakkaiden aiemmat tilanteet ilman lisämaksua.Tyhjä, kun aiempia tilanteita ei ole; kenttä puuttuu silloin, esimerkiksi OHG:llä, PartG:llä tai e.K:lla`shareholders` · Beta	–	yleensä: GmbH, UG osittain: GmbH & Co. KG, KG, OHG harvoin: AG, SE, KGaA ei koskaan: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Sen osakasluettelon päivämäärä, josta entries on peräisin.Tyhjä, kun osakkaat tulevat rekisteristä	`"2015-08-21"`	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders.history.pastarray	Aiemmat osakasluettelot uusimmasta alkaen.Tyhjä, kun luetteloita on vain yksi	–	kuten yllä
shareholders.history.past[].as_ofstring	Tämän osakasluettelon päivämäärä.	`"2015-07-28"`	kuten yllä
shareholders.history.past[].data.total_capitalobject\|null	Pääoma tämän luettelon mukaan summineen ja valuuttoineen. Vanhemmat luettelot ilmoittavat sen osin DEM-markoissa.	–	kuten yllä
shareholders.history.past[].data.shareholdersarray	Osakkaat tämän luettelon mukaan samoilla kentillä kuin entries.	–	kuten yllä
shareholders.history.register_ownershipobject	KG:llä ja GmbH & Co. KG:llä: entiset yhtiömiehet rekisterin mukaan, kentässä past.	–	osittain: GmbH & Co. KG, KG, OHG ei koskaan: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Entinen yhtiömies samoilla kentillä kuin entries-kentässä.	–	kuten yllä
shareholders.history.register_ownership.past[].roleobject	Hänen roolinsa, rakenteeltaan kuten role kentässä entries.	–	kuten yllä
shareholders.history.register_ownership.past[].effective_fromstring\|null	Mistä lähtien hänet oli rekisteröity, muodossa YYYY-MM-DD.	`"2022-01-07"`	kuten yllä
shareholders.history.register_ownership.past[].effective_tostring\|null	Mihin asti hänet oli rekisteröity.	`"2026-07-06"`	kuten yllä
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true, jos effective_to on johdettu eikä nimenomaisesti rekisteröity.	`false`	kuten yllä
shareholders.history.register_ownership.past[].contributionnull	Tässä aina null.	–	kuten yllä
shareholders.history.register_ownership.past[].contribution_rationull	Tässä aina null.	–	kuten yllä

Syvät osakastiedot

Ominaisuus shareholders_deep sisältyy Max-pakettiin. Se maksaa 80 krediittiä, mutta vain jos nykyinen asiakirja nimeää vähintään yhden haltijan.

Se lukee yrityksen kaikki osakasluettelot, ei vain uusinta. Näin se näyttää, mistä lähtien joku on omistanut osuuksia, miltä aiemmat tilanteet näyttivät ja mitä viimeisin luettelo muutti.

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

Asiakirja. record kertoo, mistä nykyinen tilanne on peräisin, share_capital antaa pääoman kyseisen asiakirjan mukaan.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholders_deepobject\|null	Haltijat, osuudet, aiemmat asiakirjat ja viimeisin muutos.Tyhjä, kun nykyistä asiakirjaa tai rekisteröityä yhtiömiestä ei tunneta, tyypillistä AG:lle, SE:lle ja eG:lle`shareholders_deep` · Max ja ylemmät	–	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.recordobject	Asiakirja, josta nykyinen tilanne on peräisin: päivämäärä ja lähde.	–	kuten yllä
shareholders_deep.record.datestring\|null	Päivämäärä, johon asiakirja viittaa. Se on yleensä pian sen muutoksen jälkeen, jonka asiakirja näyttää.Tyhjä, kun osakkaat tulevat rekisteristä (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.record.sourcestring	Asiakirjan laji.Arvot: `SHAREHOLDER_LIST` osakasluettelo (Gesellschafterliste), `FOUNDING_DOCUMENT` perustamisasiakirja eli Musterprotokoll (mallipöytäkirja) tai Gesellschaftsvertrag (yhtiöjärjestys), `COMMERCIAL_REGISTER` rekisteriin merkityt yhtiömiehet tai omistajat	`"SHAREHOLDER_LIST"`	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.share_capitalobject\|null	Pääoma asiakirjan mukaan: arvo, valuutta ja perusta.Tyhjä, kun asiakirjassa ei ole pääomaa, sekä aina COMMERCIAL_REGISTER-lähteellä	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Mistä summa on peräisin.Arvot: `REPORTED` ilmoitettu asiakirjassa, `CALCULATED` laskettu osuuksien määrästä ja nimellismäärästä	`"REPORTED"`	kuten yllä

Haltijat. Jokainen entries-merkintä on asiakirjan yksi rivi, suurin osuus ensin. Jos jollakulla on useita rivejä, hän esiintyy listassa useaan kertaan.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholders_deep.entriesarray	Nykyiset haltijat, yksi asiakirjan rivi merkintää kohden, suurin osuus ensin.`shareholders_deep` · Max ja ylemmät	–	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.entries[].holderobject	Kuka osuuden omistaa. type määrää, mitkä kentät seuraavat.	–	kuten yllä
shareholders_deep.entries[].holder.typestring	Haltijan laji.Arvot: `ORGANIZATION` yritys tai muu organisaatio, `PERSON` luonnollinen henkilö, `JOINT` yhteisesti omistettu osuus, esimerkiksi kuolinpesän, jäsenineen	`"ORGANIZATION"`	kuten yllä
shareholders_deep.entries[].holder.entity_idstring\|null	Haltijan tunniste sen omaa yritysprofiilia tai henkilöprofiilia varten.Tyhjä, kun haltijaa ei voitu yhdistää varmasti, sekä aina JOINT-tyypillä	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	kuten yllä
shareholders_deep.entries[].holder.namestring	Nimi. Yhdistetyillä haltijoilla nykyinen nimi, muuten kuten asiakirjassa.	`"ENSoXX GmbH"`	kuten yllä
shareholders_deep.entries[].holder.birth_datestring\|null	Vain henkilöillä: syntymäaika.Tyhjä, kun asiakirjassa sitä ei ole	–	aina: e.K. yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Vain organisaatioilla: yhtiömuoto tekstinä, esimerkiksi GmbH tai Ltd.	`"GmbH"`	yleensä: GmbH, UG, GmbH & Co. KG harvoin: AG, SE, KGaA, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Vain organisaatioilla: nykyinen tila rekisterissä.Tyhjä, kun haltijaa ei ole yhdistetty, sekä aina historyn aiemmissa asiakirjoissaArvot: `ACTIVE` aktiivinen, `INACTIVE` ei enää aktiivinen, esimerkiksi poistettu tai sulautunut	`"ACTIVE"`	kuten yllä
shareholders_deep.entries[].holder.citystring\|null	Kotipaikka tai asuinpaikka.	`"Gunzenhausen"`	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.entries[].holder.countrystring\|null	Maa kolmikirjaimisena ISO-koodina (ISO 3166-1 alpha-3), esimerkiksi DEU, AUT tai LUX.	`"DEU"`	kuten yllä
shareholders_deep.entries[].holder.registrationobject\|null	Vain organisaatioilla: court, register_type ja register_number.Tyhjä, kun rekisterimerkintää ei voida lukea, esimerkiksi monilla ulkomaisilla yrityksillä	–	yleensä: GmbH, UG, GmbH & Co. KG harvoin: AG, SE, KGaA, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Vain organisaatioilla: rekisterimerkintä tekstinä, kun registration puuttuu tai ei nimeä tuomioistuinta.	`null`	harvoin
shareholders_deep.entries[].rolestring	Haltijan rooli. Uusia arvoja voi tulla lisää.Arvot: `SHAREHOLDER` osakas osakasluettelon tai perustamisasiakirjan mukaan, `LIMITED_PARTNER` äänetön yhtiömies (Kommanditist), `FULLY_LIABLE_PARTNER` henkilökohtaisesti vastuunalainen yhtiömies (persönlich haftender Gesellschafter), `PARTNER` PartG:n partneri, `OWNER` e.K.:n omistaja	`"SHAREHOLDER"`	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.entries[].sincestring\|null	Mistä lähtien haltija on omistanut osuuksia. Rekisteröidyillä yhtiömiehillä rekisteröintipäivä.Tyhjä, kun päivämäärää ei voida määrittää, sekä aina JOINT-tyypillä	`"2015-08-18"`	kuten yllä
shareholders_deep.entries[].since_basisstring\|null	Kuinka varma since on.Arvot: `ENTRY_RECORDED` dokumentoitu tästä päivästä alkaen: edellinen luettelo ei vielä nimeä haltijaa, `EARLIEST_RECORD` mukana jo vanhimmassa saatavilla olevassa asiakirjassa, eli osakas vähintään tästä päivästä alkaen	`"ENTRY_RECORDED"`	kuten yllä

Osuus. ownership kuvaa, kuinka paljon haltija omistaa: prosentteina, nimellismääränä ja osuuksien juoksevina numeroina.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholders_deep.entries[].ownershipobject	Haltijan osuus.`shareholders_deep` · Max ja ylemmät	–	yleensä: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG harvoin: AG, SE, KGaA ei koskaan: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Osuus pääomasta prosentteina, 0–100. Kyse on suorasta omistuksesta, ei äänivallasta.Tyhjä, kun osuutta ei voida määrittää luotettavasti, sekä aina henkilöyhtiöiden rekisteröidyillä yhtiömiehillä	`94.5`	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Mistä percentage on peräisin.Arvot: `REPORTED` ilmoitettu asiakirjassa tai johdettu asiakirjan nimellismäärästä ja pääomasta, `CALCULATED` laskettu osuuksien määrästä ja nimellismäärästä	`"REPORTED"`	kuten yllä
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Nimellismäärien summa arvoineen ja valuuttoineen. Äänettömillä yhtiömiehillä rekisteröity vastuusumma (Haftsumme).Tyhjä, kun summaa ei tunneta	–	yleensä: GmbH, UG, GmbH & Co. KG osittain: KG, OHG harvoin: AG, SE, KGaA ei koskaan: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Osuuksien (Geschäftsanteile) lukumäärä.Tyhjä, kun lukumäärää ei tunneta kaikista osuuksista	`47250`	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Osuudet luettelon juoksevien numeroiden mukaan, yksi väli kutakin samanlaisten osuuksien jaksoa kohden.	–	kuten yllä
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Välin ensimmäinen juokseva numero.	`1`	kuten yllä
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Välin viimeinen juokseva numero.	`47250`	kuten yllä
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Osuuksien määrä välillä.	`47250`	kuten yllä
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Nimellismäärä osuutta kohden välillä, arvoineen ja valuuttoineen.	–	kuten yllä

Historia ja muutokset. history sisältää aiemmat asiakirjat samoilla kentillä. Haltijat näkyvät siellä sellaisina kuin he olivat silloisessa asiakirjassa. changes vertaa nykyistä tilannetta edelliseen.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholders_deep.historyarray	Aiemmat asiakirjat uusimmasta alkaen, kukin kentillä record, share_capital ja entries. Entiset rekisteröidyt yhtiömiehet on koottu viimeiseen merkintään.`shareholders_deep` · Max ja ylemmät	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	JOINT-tyypillä: yhteisomistajat tyyppiä PERSON tai ORGANIZATION samoilla kentillä kuin holder.	–	harvoin
shareholders_deep.history[].entries[].untilstring\|null	Vain historyn COMMERCIAL_REGISTER-merkinnässä: milloin yhtiömies erosi.	–	osittain: GmbH & Co. KG, KG, OHG, PartG harvoin: e.K. ei koskaan: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Mikä muuttui nykyisessä asiakirjassa edelliseen verrattuna.Tyhjä, kun aiempaa asiakirjaa ei ole, sekä silloin kun nykyinen tilanne tulee rekisteristä tai perustamisasiakirjasta	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Edellisen asiakirjan päivämäärä.	`"2015-07-16"`	kuten yllä
shareholders_deep.changes.joinedarray	Uudet haltijat: holder kentillä entity_id, type ja name sekä percentage.	–	kuten yllä
shareholders_deep.changes.leftarray	Poistuneet haltijat viimeisimmän osuutensa kanssa.	–	kuten yllä
shareholders_deep.changes.changedarray	Haltijat, joiden osuus muuttui.	–	kuten yllä
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Osuus prosentteina edellisessä asiakirjassa.	`100`	kuten yllä
shareholders_deep.changes.changed[].percentage_afternumber\|null	Osuus prosentteina nykyisessä asiakirjassa.	`5.5`	kuten yllä

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 · Esimerkkivastaus: Hetzner Online GmbH ominaisuudella shareholders_deep

Verrattuna shareholders-ominaisuuteen shareholders_deep lisää osuusnumerot, päivämäärän, josta lähtien joku on omistanut osuuksia, muutokset sekä yhteisesti omistetut osuudet jäsenineen. Yritysten ja vuosien välisiin vertailuihin kannattaa käyttää samaa ominaisuutta läpi linjan.

Tosiasialliset edunsaajat

Tosiasialliset edunsaajat ovat luonnollisia henkilöitä, jotka viime kädessä omistavat yrityksen. Ominaisuus ubos seuraa osakasluetteloita omistustasojen läpi henkilöihin asti. Lista nimeää jokaisen henkilön, jolla on laskettu osuus, ilman alarajaa. Se maksaa 10 krediittiä, kun se palauttaa tietoja.

Jos osuutta ei voida jäljittää henkilöön, se on kentässä unresolved_beneficial_owners syineen. Usein sen omistaa ulkomainen yritys. Tietomme kattavat saksalaiset yritykset, joten emme tunne ulkomaisen yrityksen osakkaita. coverage näyttää, kuinka monta prosenttia pääomasta on jäljitetty henkilöihin ja kuinka paljon jää avoimeksi. Arvot eivät aina ole yhteensä 100. Lopulle osakastiedot eivät nimeä haltijaa.

Ominaisuus veloitetaan heti, kun se palauttaa tuloksen. Tämä pätee myös silloin, kun kaikki osuudet ovat kentässä unresolved_beneficial_owners.

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

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
ubosobject\|null	Tosiasialliset edunsaajat osakasluetteloista omistustasojen läpi laskettuina.Tyhjä, kun osakasluetteloista ei voida muodostaa ketjua, esimerkiksi AG:llä, eG:llä tai e.K:lla`ubos` · Beta	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
ubos.beneficial_ownersarray	Henkilöt, jotka omistavat yrityksen suoraan tai muiden yritysten kautta.Tyhjä, kun yhtään osuutta ei voida jäljittää henkilöön	–	kuten yllä
ubos.beneficial_owners[].personobject	Henkilö alla olevin kentin.	–	osittain: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	Henkilön tunniste henkilöprofiilia varten.Tyhjä, kun henkilöä ei voitu yhdistää varmasti	–	kuten yllä
ubos.beneficial_owners[].person.namestring	Koko nimi.	–	kuten yllä
ubos.beneficial_owners[].person.name_partsobject	Nimi osina: given ja family sekä canonical_name, jos tiedossa.	–	kuten yllä
ubos.beneficial_owners[].person.birth_datestring\|null	Syntymäaika.	–	kuten yllä
ubos.beneficial_owners[].person.locationobject\|null	Asuinpaikka kentässä home: city, county, state ja country.Tyhjä, kun asuinpaikkaa ei tunneta	–	kuten yllä
ubos.beneficial_owners[].ownership_percentagenumber	Henkilön kokonaisosuus prosentteina, laskettuna yhteen kaikkien polkujen yli.	`50`	kuten yllä
ubos.beneficial_owners[].pathsarray	Jokainen polku henkilöön osuuksineen kyseistä polkua pitkin.	–	kuten yllä
ubos.beneficial_owners[].paths[].percentagenumber	Osuus prosentteina, joka tulee tätä polkua pitkin.	`50`	kuten yllä
ubos.beneficial_owners[].paths[].viaarray	Tämän polun yritykset, ensin haetun yrityksen suora osakas (depth 1). Kentät ovat samat kuin selvittämättömien osuuksien via-kentässä.Tyhjä, kun henkilö omistaa osuudet suoraan	–	kuten yllä

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
ubos.unresolved_beneficial_ownersarray	Osuudet, joita ei voitu jäljittää henkilöön.Tyhjä, kun kaikki osuudet on selvitetty`ubos` · Beta	–	yleensä: GmbH, UG harvoin: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ei koskaan: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Miksi ketju päättyy tähän. Uusia arvoja voi tulla lisää.Arvot: `unlinked` osakas on yritys, jota emme pysty yhdistämään Saksan rekisterin merkintään, yleensä ulkomainen yritys. Emme tunne sen osakkaita, joten ketju päättyy tähän, `no_further_shareholder_data` osakas on tuntemamme saksalainen yritys, mutta sille ei ole osakasluetteloa, esimerkiksi KG, `cycle` ketju johtaa takaisin yritykseen, joka on jo ketjussa, esimerkiksi kun yritys omistaa omia osuuksiaan, `unknown` osakkaasta ei tiedetä mitään, ei nimeä eikä osuutta	`"cycle"`	kuten yllä
ubos.unresolved_beneficial_owners[].namestring\|null	Sen osakkaan nimi, johon ketju päättyy.Tyhjä, kun syy on unknown	`"ENSoXX Holding AG"`	kuten yllä
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Sen tunniste sen omaa yritysprofiilia varten.Tyhjä, kun osakasta ei ole yhdistetty tietojemme yritykseen, eli syillä unlinked ja unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	kuten yllä
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Sen yhtiömuoto.	`"AG"`	kuten yllä
ubos.unresolved_beneficial_owners[].addressobject\|array	Sen osoite kentillä street, house_number, postal_code, city, county, state, country ja coordinates.Tyhjä, kun osoitetta ei tunneta; arvo on silloin tyhjä lista []	–	kuten yllä
ubos.unresolved_beneficial_owners[].registrationobject\|array	Sen rekisterimerkintä kentillä court, register_type ja register_number, myös ulkomaisista rekistereistä.Tyhjä, kun merkintää ei tunneta; arvo on silloin tyhjä lista []	–	kuten yllä
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Selvittämätön osuus prosentteina, laskettuna haettuun yritykseen asti. Se voi olla 0.	`0`	kuten yllä
ubos.unresolved_beneficial_owners[].viaarray	Yritykset, joiden kautta ketju kulkee tähän asti, ensin haetun yrityksen suora osakas.Tyhjä, kun selvittämätön osuus on suoraan haetussa yrityksessä	–	kuten yllä
ubos.unresolved_beneficial_owners[].via[].depthinteger	Taso: 1 on haetun yrityksen suora osakas. Sen vieressä ovat yrityksen name ja entity_id.	`1`	kuten yllä
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Osuus prosentteina tällä tasolla.	`94.5`	kuten yllä
ubos.coverageobject	Kuinka paljon pääomasta on jäljitetty henkilöihin ja kuinka paljon jää avoimeksi. Arvot eivät aina ole yhteensä 100.	–	kuten yllä
ubos.coverage.resolved_percentagenumber	Henkilöihin jäljitetty osuus prosentteina.	`5.5`	kuten yllä
ubos.coverage.unresolved_percentagenumber	Henkilöihin jäljittämätön osuus prosentteina.	`0`	kuten yllä

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 · Esimerkkivastaus: Hetzner Online GmbH ominaisuudella ubos. Esimerkkihaussamme yksi henkilö oli kentässä beneficial_owners 5,5 %:n osuudella. Ketju ENSoXX GmbH:n, Ansbach HRB 6105, kautta päättyi kenttään unresolved_beneficial_owners syillä cycle ja unknown.

Laskemme tiedot osakasluetteloista. Transparenzregisterin (avoimuusrekisteri) tosiasiallisten edunsaajien tiedot eivät ole olleet julkisesti saatavilla vuoden 2022 lopun jälkeen.

Omistukset

Ominaisuus shareholdings näyttää toisen suunnan: missä yrityksissä haetulla yrityksellä on osuuksia. Omistukset tulevat kyseisten yritysten osakasluetteloista. Se maksaa 5 krediittiä, kun omistuksia on.

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

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholdingsobject\|null	Yritykset, joissa haetulla yrityksellä on osuuksia.Tyhjä, kun omistuksia ei tunneta`shareholdings` · Beta	–	yleensä: AG, SE, KGaA osittain: GmbH, UG harvoin: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Nykyiset omistukset, yksi yritystä kohden.	–	kuten yllä
shareholdings.holdings.current[].organizationobject	Yritys, jossa osuuksia omistetaan.	–	kuten yllä
shareholdings.holdings.current[].organization.entity_idstring	Yrityksen tunniste sen yritysprofiilia varten.	`"63529c3a793e9f002196b4fd344e1241"`	kuten yllä
shareholdings.holdings.current[].organization.namestring\|null	Yrityksen nimi.	`"Hetzner Cloud GmbH"`	kuten yllä
shareholdings.holdings.current[].organization.legal_formstring\|null	Yrityksen yhtiömuoto.	`"GmbH"`	kuten yllä
shareholdings.holdings.current[].organization.statusstring\|null	Yrityksen tila rekisterissä, esimerkiksi ACTIVE.	`"ACTIVE"`	kuten yllä
shareholdings.holdings.current[].organization.addressobject\|array	Yrityksen osoite, rakenteeltaan kuten address perustiedoissa.Tyhjä, kun osoitetta ei tunneta; arvo on silloin tyhjä lista []	–	kuten yllä
shareholdings.holdings.current[].organization.registrationobject\|array	Yrityksen rekisterimerkintä kentillä court, register_type ja register_number.Tyhjä, kun merkintää ei tunneta; arvo on silloin tyhjä lista []	–	kuten yllä
shareholdings.holdings.current[].ownership.percentagenumber\|null	Osuus prosentteina: 100 tarkoittaa 100 %.Tyhjä, kun luettelosta ei saada osuutta	`100`	kuten yllä
shareholdings.holdings.current[].ownership.contributionobject	Osuuksien nimellismäärä summineen ja valuuttoineen.	–	kuten yllä
shareholdings.holdings.current[].as_ofstring	Sen osakasluettelon päivämäärä, josta omistus on peräisin.	`"2017-09-19"`	kuten yllä
shareholdings.summary.total_currentinteger	Nykyisten omistusten lukumäärä.	`2`	kuten yllä

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 · Esimerkkivastaus: Hetzner Online GmbH ominaisuudella shareholdings

Henkilön omistukset ovat henkilöprofiilissa samalla ominaisuudella.

Konsernirakenteet

Konserniyhteydet kokoat useista tietopisteistä. shareholders ja shareholdings näyttävät omistukset tason ylös- ja alaspäin, ubos ketjun päässä olevat henkilöt.

Yritysverkosto yhdistää yritykset ja henkilöt kahden tason yli. Se sisältää myös sidosyritykset.

Sulautumiset, jakautumiset ja muut yritysjärjestelyt löytyvät kohdasta Sulautumiset & yritysostot.