Společníci a účasti – Dokumentace

Funkce
Funkce	Co vrací	Kredity	K dispozici
shareholders	Společníci: současní společníci s jejich podíly a dřívější seznamy společníků	5	každý účet · Beta
shareholders_deep	Podrobní společníci: držitelé s čísly obchodních podílů, od kdy podíly drží a co se naposledy změnilo	80	Max
ubos	Skuteční majitelé (UBO): osoby za firmou, vypočtené ze seznamů společníků	10	každý účet · Beta
shareholdings	Majetkové účasti: firmy, ve kterých má firma sama podíly	5	každý účet · Beta

Společníci podle právní formy

Co rejstřík říká o vlastnících, závisí na právní formě. Tabulka ukazuje, co typicky dostaneš.

Právní forma
Právní forma	Společníci v odpovědi
GmbH, UG	Všichni společníci ze seznamu společníků podle § 40 GmbHG, s jmenovitou hodnotou a podílem na základním kapitálu (Stammkapital), plus dřívější seznamy.
AG, SE, KGaA	Jen v jednotlivých případech, protože akcionáři AG nejsou v žádném veřejném rejstříku.
GmbH & Co. KG	Komanditisté (Kommanditisten) z rejstříku s výší ručení, částečně i komplementářská GmbH.
KG, OHG	Zapsaní společníci: u KG komplementáři (Komplementäre) a komanditisté, u OHG osobně ručící společníci.
e.K.	Majitel.
eG	Žádní. Seznam členů družstva není veřejný.
PartG	Zapsaní partneři.

Seznamy společníků jsou často naskenované dokumenty v mnoha rozvrženích. Extrahujeme je automaticky. Používáme k tomu nejnovější technologie a hodně investujeme do kvality; jednotlivé chyby přesto nelze vyloučit.

Společníci

Funkce shareholders vrací současné společníky: u GmbH z nejnovějšího seznamu společníků, u osobních společností a jednotlivců zapsaných jako kupci z rejstříku. Stojí 5 kreditů, ale jen když uvádí současné společníky. Pokud vrací jen dřívější seznamy, nestojí nic.

Každý záznam v entries popisuje osobu nebo firmu. Osoba má first_name, last_name a birth_date, firma entity_name, country_code a registration_reference.

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

Pole
Pole	Význam	Příklad	Dostupnost
shareholdersobject\|null	Společníci firmy: aktuální stav v entries, dřívější stavy v history.Prázdné, když nejsou známi žádní společníci, například u AG nebo eG`shareholders` · Beta	–	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders.entriesarray	Současní společníci, jeden záznam na osobu nebo firmu.	–	jako výše
shareholders.entries[].shareholderobject	Kdo podíl drží: osoba nebo firma, s poli níže.	–	jako výše
shareholders.entries[].shareholder.entity_idstring\|null	ID osoby nebo firmy, pro její vlastní profil osoby nebo profil firmy.Prázdné, když společníka se nepodařilo spolehlivě přiřadit	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	jako výše
shareholders.entries[].shareholder.first_namestring	Křestní jméno osoby, se všemi zapsanými křestními jmény.	–	vždy: e.K. většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders.entries[].shareholder.last_namestring	Příjmení osoby.	–	jako výše
shareholders.entries[].shareholder.birth_datestring\|null	Datum narození osoby, ve formátu YYYY-MM-DD.Prázdné, když dokument neuvádí datum narození	–	jako výše
shareholders.entries[].shareholder.entity_namestring	Název firmy, která je společníkem.	`"ENSoXX GmbH"`	většinou: GmbH, UG, GmbH & Co. KG zřídka: AG, SE, KGaA, KG, OHG nikdy: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Země firmy jako třípísmenný kód ISO (ISO 3166-1 alpha-3), například DEU.	`"DEU"`	jako výše
shareholders.entries[].shareholder.registration_referencestring\|null	Zápis firmy v rejstříku jako text, jak je uveden v dokumentu.Prázdné, když dokument neuvádí zápis v rejstříku, často u zahraničních firem	`"AG Ansbach HRB 6105"`	jako výše
shareholders.entries[].shareholder.addressstring\|null	Adresa, bydliště nebo sídlo jako text, jak je uvedeno v dokumentu.Prázdné, když dokument neuvádí adresu	`"Gunzenhausen"`	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders.entries[].contributionobject\|null	Výše účasti s amount a currency: u GmbH jmenovitá hodnota obchodních podílů, u komanditistů zapsaná výše ručení (Haftsumme).Prázdné, když není zapsána žádná částka, například u osobně ručících společníků nebo majitele e.K.	–	většinou: GmbH, UG, GmbH & Co. KG částečně: KG, OHG zřídka: AG, SE, KGaA nikdy: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Podíl na kapitálu jako desetinné číslo: 1 znamená 100 %, 0.245 znamená 24,5 %.Prázdné, když podíl nelze odvodit, například u osobních společností	`0.945`	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders.entries[].roleobject	Role: label jako pevný kód, plus de a en s dlouhým a krátkým názvem, například Kommanditist a Kom.	–	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders.entries[].role.labelstring	Role jako pevný kód. Mohou přibýt nové hodnoty.Hodnoty: `SHAREHOLDER` společník podle seznamu společníků, `LIMITED_PARTNER` komanditista (Kommanditist), `FULLY_LIABLE_PARTNER` osobně ručící společník (persönlich haftender Gesellschafter), `PARTNER` partner PartG, `OWNER` majitel e.K.	`"SHAREHOLDER"`	jako výše
shareholders.total_capitalobject\|null	Kapitál podle seznamu společníků, s amount a currency, základ pro contribution_ratio.Prázdné, když seznam neuvádí kapitál, a u osobních společností	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG

Pomocí entity_id společníka načteš jeho vlastní profil firmy nebo profil osoby. Tak sleduješ vlastnický řetězec úroveň po úrovni.

Historie společníků

shareholders.history přichází bez příplatku. Obsahuje datum aktuálního seznamu a dřívější seznamy společníků, nejnovější první.

U KG nebo GmbH & Co. KG jsou bývalí společníci v register_ownership, s daty vstupu a výstupu z rejstříku. U OHG, PartG a e.K. je najdeš v shareholders_deep.

Pole
Pole	Význam	Příklad	Dostupnost
shareholders.historyobject	Dřívější stavy společníků, bez příplatku.Prázdné, když neexistují žádné dřívější stavy; pole pak chybí, například u OHG, PartG nebo e.K.`shareholders` · Beta	–	většinou: GmbH, UG částečně: GmbH & Co. KG, KG, OHG zřídka: AG, SE, KGaA nikdy: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Datum seznamu společníků, ze kterého pochází entries.Prázdné, když společníci pocházejí z rejstříku	`"2015-08-21"`	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders.history.pastarray	Dřívější seznamy společníků, nejnovější první.Prázdné, když existuje jen jeden seznam	–	jako výše
shareholders.history.past[].as_ofstring	Datum tohoto seznamu společníků.	`"2015-07-28"`	jako výše
shareholders.history.past[].data.total_capitalobject\|null	Kapitál podle tohoto seznamu, s amount a currency. Starší seznamy ho částečně uvádějí v DEM.	–	jako výše
shareholders.history.past[].data.shareholdersarray	Společníci podle tohoto seznamu, se stejnými poli jako entries.	–	jako výše
shareholders.history.register_ownershipobject	U KG a GmbH & Co. KG: bývalí společníci podle rejstříku, v past.	–	částečně: GmbH & Co. KG, KG, OHG nikdy: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Bývalý společník, se stejnými poli jako v entries.	–	jako výše
shareholders.history.register_ownership.past[].roleobject	Jeho role, strukturovaná jako role v entries.	–	jako výše
shareholders.history.register_ownership.past[].effective_fromstring\|null	Od kdy byl zapsán, ve formátu YYYY-MM-DD.	`"2022-01-07"`	jako výše
shareholders.history.register_ownership.past[].effective_tostring\|null	Do kdy byl zapsán.	`"2026-07-06"`	jako výše
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true, pokud je effective_to odvozené a ne výslovně zapsané.	`false`	jako výše
shareholders.history.register_ownership.past[].contributionnull	Zde vždy null.	–	jako výše
shareholders.history.register_ownership.past[].contribution_rationull	Zde vždy null.	–	jako výše

Podrobní společníci

Funkce shareholders_deep je součástí tarifu Max. Stojí 80 kreditů, ale jen když aktuální dokument uvádí alespoň jednoho držitele.

Čte všechny seznamy společníků firmy, ne jen nejnovější. Ukazuje tak, od kdy někdo drží podíly, jak vypadaly dřívější stavy a co změnil poslední seznam.

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

Dokument. record říká, odkud pochází aktuální stav, share_capital uvádí kapitál podle tohoto dokumentu.

Pole
Pole	Význam	Příklad	Dostupnost
shareholders_deepobject\|null	Držitelé, podíly, dřívější dokumenty a poslední změna.Prázdné, když není znám žádný aktuální dokument ani zapsaný společník, typicky u AG, SE a eG`shareholders_deep` · od Max	–	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.recordobject	Dokument, ze kterého pochází aktuální stav: datum a zdroj.	–	jako výše
shareholders_deep.record.datestring\|null	Datum, ke kterému se dokument vztahuje. Obvykle je krátce po změně, kterou dokument ukazuje.Prázdné, když společníci pocházejí z rejstříku (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.record.sourcestring	Druh dokumentu.Hodnoty: `SHAREHOLDER_LIST` seznam společníků (Gesellschafterliste), `FOUNDING_DOCUMENT` zakladatelský dokument, tj. Musterprotokoll (vzorový protokol) nebo Gesellschaftsvertrag (společenská smlouva), `COMMERCIAL_REGISTER` společníci nebo majitelé zapsaní v rejstříku	`"SHAREHOLDER_LIST"`	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.share_capitalobject\|null	Kapitál podle dokumentu: value, currency a basis.Prázdné, když dokument neuvádí kapitál, a vždy u COMMERCIAL_REGISTER	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Odkud částka pochází.Hodnoty: `REPORTED` uvedeno v dokumentu, `CALCULATED` vypočteno z počtu a jmenovité hodnoty obchodních podílů	`"REPORTED"`	jako výše

Držitelé. Každý záznam v entries je jeden řádek dokumentu, největší podíl první. Pokud má někdo více řádků, objeví se v seznamu vícekrát.

Pole
Pole	Význam	Příklad	Dostupnost
shareholders_deep.entriesarray	Současní držitelé, jeden řádek dokumentu na záznam, největší podíl první.`shareholders_deep` · od Max	–	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.entries[].holderobject	Kdo podíl drží. type určuje, která pole následují.	–	jako výše
shareholders_deep.entries[].holder.typestring	Druh držitele.Hodnoty: `ORGANIZATION` firma nebo jiná organizace, `PERSON` fyzická osoba, `JOINT` společně držený podíl, například společenství dědiců, s members	`"ORGANIZATION"`	jako výše
shareholders_deep.entries[].holder.entity_idstring\|null	ID držitele, pro jeho vlastní profil firmy nebo profil osoby.Prázdné, když držitele se nepodařilo spolehlivě přiřadit, a vždy u JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	jako výše
shareholders_deep.entries[].holder.namestring	Název nebo jméno. U přiřazených držitelů aktuální, jinak jako v dokumentu.	`"ENSoXX GmbH"`	jako výše
shareholders_deep.entries[].holder.birth_datestring\|null	Jen u osob: datum narození.Prázdné, když dokument žádné neuvádí	–	vždy: e.K. většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Jen u organizací: právní forma jako text, například GmbH nebo Ltd.	`"GmbH"`	většinou: GmbH, UG, GmbH & Co. KG zřídka: AG, SE, KGaA, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Jen u organizací: aktuální stav v rejstříku.Prázdné, když držitel není přiřazen, a vždy v dřívějších dokumentech v historyHodnoty: `ACTIVE` aktivní, `INACTIVE` již neaktivní, například vymazaná nebo sloučená	`"ACTIVE"`	jako výše
shareholders_deep.entries[].holder.citystring\|null	Sídlo nebo bydliště.	`"Gunzenhausen"`	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.entries[].holder.countrystring\|null	Země jako třípísmenný kód ISO (ISO 3166-1 alpha-3), například DEU, AUT nebo LUX.	`"DEU"`	jako výše
shareholders_deep.entries[].holder.registrationobject\|null	Jen u organizací: court, register_type a register_number.Prázdné, když zápis v rejstříku nelze přečíst, například u mnoha zahraničních firem	–	většinou: GmbH, UG, GmbH & Co. KG zřídka: AG, SE, KGaA, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Jen u organizací: zápis v rejstříku jako text, pokud registration chybí nebo neuvádí soud.	`null`	zřídka
shareholders_deep.entries[].rolestring	Role držitele. Mohou přibýt nové hodnoty.Hodnoty: `SHAREHOLDER` společník podle seznamu společníků nebo zakladatelského dokumentu, `LIMITED_PARTNER` komanditista (Kommanditist), `FULLY_LIABLE_PARTNER` osobně ručící společník (persönlich haftender Gesellschafter), `PARTNER` partner PartG, `OWNER` majitel e.K.	`"SHAREHOLDER"`	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.entries[].sincestring\|null	Od kdy držitel drží podíly. U zapsaných společníků datum zápisu.Prázdné, když datum nelze určit, a vždy u JOINT	`"2015-08-18"`	jako výše
shareholders_deep.entries[].since_basisstring\|null	Jak jisté je since.Hodnoty: `ENTRY_RECORDED` doloženo od tohoto data: předchozí seznam držitele ještě neuvádí, `EARLIEST_RECORD` už v nejstarším dostupném dokumentu, tedy společníkem nejméně od tohoto data	`"ENTRY_RECORDED"`	jako výše

Podíl. ownership popisuje, kolik držitel drží: v procentech, jako jmenovitou hodnotu a podle pořadových čísel obchodních podílů.

Pole
Pole	Význam	Příklad	Dostupnost
shareholders_deep.entries[].ownershipobject	Podíl držitele.`shareholders_deep` · od Max	–	většinou: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG zřídka: AG, SE, KGaA nikdy: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Podíl na kapitálu v procentech, od 0 do 100. Jde o přímou účast, ne o hlasovací práva.Prázdné, když podíl nelze spolehlivě určit, a vždy u zapsaných společníků osobních společností	`94.5`	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Odkud percentage pochází.Hodnoty: `REPORTED` uvedeno v dokumentu nebo odvozeno z jmenovité hodnoty a kapitálu v dokumentu, `CALCULATED` vypočteno z počtu a jmenovité hodnoty obchodních podílů	`"REPORTED"`	jako výše
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Součet jmenovitých hodnot s value a currency. U komanditistů zapsaná výše ručení (Haftsumme).Prázdné, když není známa žádná částka	–	většinou: GmbH, UG, GmbH & Co. KG částečně: KG, OHG zřídka: AG, SE, KGaA nikdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Počet obchodních podílů (Geschäftsanteile).Prázdné, když počet není znám u všech podílů	`47250`	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Obchodní podíly podle pořadových čísel v seznamu, jeden rozsah na sled stejných podílů.	–	jako výše
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	První pořadové číslo rozsahu.	`1`	jako výše
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Poslední pořadové číslo rozsahu.	`47250`	jako výše
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Počet obchodních podílů v rozsahu.	`47250`	jako výše
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Jmenovitá hodnota na obchodní podíl v rozsahu, s value a currency.	–	jako výše

Historie a změny. history obsahuje dřívější dokumenty se stejnými poli. Držitelé jsou tam tak, jak stáli v tehdejším dokumentu. changes porovnává aktuální stav s předchozím.

Pole
Pole	Význam	Příklad	Dostupnost
shareholders_deep.historyarray	Dřívější dokumenty, nejnovější první, každý s record, share_capital a entries. Bývalí zapsaní společníci jsou shromážděni v posledním záznamu.`shareholders_deep` · od Max	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	U JOINT: spoludržitelé typu PERSON nebo ORGANIZATION, se stejnými poli jako holder.	–	zřídka
shareholders_deep.history[].entries[].untilstring\|null	Jen v položce history s COMMERCIAL_REGISTER: kdy společník odešel.	–	částečně: GmbH & Co. KG, KG, OHG, PartG zřídka: e.K. nikdy: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Co se s aktuálním dokumentem změnilo oproti předchozímu.Prázdné, když neexistuje žádný dřívější dokument, a když aktuální stav pochází z rejstříku nebo ze zakladatelského dokumentu	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Datum předchozího dokumentu.	`"2015-07-16"`	jako výše
shareholders_deep.changes.joinedarray	Noví držitelé: holder s entity_id, type a name, plus percentage.	–	jako výše
shareholders_deep.changes.leftarray	Držitelé, kteří odešli, s podílem, který naposledy měli.	–	jako výše
shareholders_deep.changes.changedarray	Držitelé, jejichž podíl se změnil.	–	jako výše
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Podíl v procentech v předchozím dokumentu.	`100`	jako výše
shareholders_deep.changes.changed[].percentage_afternumber\|null	Podíl v procentech v aktuálním dokumentu.	`5.5`	jako výše

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 · Ukázková odpověď: Hetzner Online GmbH s funkcí shareholders_deep

Oproti shareholders přidává shareholders_deep čísla obchodních podílů, datum, od kdy někdo podíly drží, změny a společně držené podíly s jejich členy. Pro porovnání napříč firmami a roky je nejlepší používat všude stejnou funkci.

Skuteční majitelé

Skuteční majitelé jsou fyzické osoby, kterým firma v konečném důsledku patří. Funkce ubos sleduje seznamy společníků přes vlastnické úrovně až k osobám. Seznam uvádí každou osobu s vypočteným podílem, bez minimální hranice. Stojí 10 kreditů, když vrátí data.

Pokud podíl nelze dohledat k osobě, je s důvodem v unresolved_beneficial_owners. Často ho drží firma v zahraničí. Naše data pokrývají německé firmy, proto společníky firmy v zahraničí neznáme. coverage ukazuje, kolik procent kapitálu je dohledáno k osobám a kolik zůstává otevřeno. Součet obou hodnot nemusí vždy dát 100. Pro zbytek údaje o společnících žádného držitele neuvádějí.

Funkce se účtuje, jakmile vrátí výsledek. To platí i tehdy, když jsou všechny podíly v unresolved_beneficial_owners.

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

Pole
Pole	Význam	Příklad	Dostupnost
ubosobject\|null	Skuteční majitelé, vypočtení ze seznamů společníků přes vlastnické úrovně.Prázdné, když ze seznamů společníků nelze sestavit žádný řetězec, například u AG, eG nebo e.K.`ubos` · Beta	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
ubos.beneficial_ownersarray	Osoby, kterým firma patří přímo nebo přes jiné firmy.Prázdné, když žádný podíl nelze dohledat k osobě	–	jako výše
ubos.beneficial_owners[].personobject	Osoba, s poli níže.	–	částečně: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID osoby, pro profil osoby.Prázdné, když osobu se nepodařilo spolehlivě přiřadit	–	jako výše
ubos.beneficial_owners[].person.namestring	Celé jméno.	–	jako výše
ubos.beneficial_owners[].person.name_partsobject	Jméno v částech: given a family, a canonical_name, pokud je známé.	–	jako výše
ubos.beneficial_owners[].person.birth_datestring\|null	Datum narození.	–	jako výše
ubos.beneficial_owners[].person.locationobject\|null	Bydliště v home: city, county, state a country.Prázdné, když není známé žádné bydliště	–	jako výše
ubos.beneficial_owners[].ownership_percentagenumber	Celkový podíl osoby v procentech, sečtený přes všechny cesty.	`50`	jako výše
ubos.beneficial_owners[].pathsarray	Každá cesta k osobě, s podílem podél této cesty.	–	jako výše
ubos.beneficial_owners[].paths[].percentagenumber	Podíl v procentech, který přichází touto cestou.	`50`	jako výše
ubos.beneficial_owners[].paths[].viaarray	Firmy na této cestě, nejprve přímý společník vyžádané firmy (depth 1). Pole jsou stejná jako ve via nevyřešených podílů.Prázdné, když osoba drží podíly přímo	–	jako výše

Pole
Pole	Význam	Příklad	Dostupnost
ubos.unresolved_beneficial_ownersarray	Podíly, které nelze dohledat k osobě.Prázdné, když všechny podíly jsou vyřešené`ubos` · Beta	–	většinou: GmbH, UG zřídka: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nikdy: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Proč zde řetězec končí. Mohou přibýt nové hodnoty.Hodnoty: `unlinked` společník je firma, kterou nedokážeme přiřadit k zápisu v německém rejstříku, obvykle firma v zahraničí. Její společníky neznáme, proto řetězec zde končí, `no_further_shareholder_data` společník je německá firma, kterou známe, ale neexistuje k ní seznam společníků, například KG, `cycle` řetězec vede zpět k firmě, která už v něm je, například když firma drží vlastní podíly, `unknown` o společníkovi není nic známo, ani jméno, ani podíl	`"cycle"`	jako výše
ubos.unresolved_beneficial_owners[].namestring\|null	Název společníka, u kterého řetězec končí.Prázdné, když důvod je unknown	`"ENSoXX Holding AG"`	jako výše
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Jeho ID, pro jeho vlastní profil firmy.Prázdné, když společník není přiřazen k firmě v našich datech, tj. u důvodů unlinked a unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	jako výše
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Jeho právní forma.	`"AG"`	jako výše
ubos.unresolved_beneficial_owners[].addressobject\|array	Jeho adresa se street, house_number, postal_code, city, county, state, country a coordinates.Prázdné, když není známá žádná adresa; hodnota je pak prázdný seznam []	–	jako výše
ubos.unresolved_beneficial_owners[].registrationobject\|array	Jeho zápis v rejstříku s court, register_type a register_number, i ze zahraničních rejstříků.Prázdné, když není známý žádný zápis; hodnota je pak prázdný seznam []	–	jako výše
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Nevyřešený podíl v procentech, přepočtený až na vyžádanou firmu. Může být 0.	`0`	jako výše
ubos.unresolved_beneficial_owners[].viaarray	Firmy, přes které řetězec až sem vede, nejprve přímý společník vyžádané firmy.Prázdné, když nevyřešený podíl je držen přímo ve vyžádané firmě	–	jako výše
ubos.unresolved_beneficial_owners[].via[].depthinteger	Úroveň: 1 je přímý společník vyžádané firmy. Vedle jsou název a entity_id firmy.	`1`	jako výše
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Podíl v procentech na této úrovni.	`94.5`	jako výše
ubos.coverageobject	Kolik kapitálu je dohledáno k osobám a kolik zůstává otevřeno. Součet obou hodnot nemusí vždy dát 100.	–	jako výše
ubos.coverage.resolved_percentagenumber	Dohledáno k osobám, v procentech.	`5.5`	jako výše
ubos.coverage.unresolved_percentagenumber	Nedohledáno k osobám, v procentech.	`0`	jako výše

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 · Ukázková odpověď: Hetzner Online GmbH s funkcí ubos. V našem ukázkovém požadavku byla jedna osoba s 5,5 % v beneficial_owners. Řetězec přes ENSoXX GmbH, Ansbach HRB 6105, skončil v unresolved_beneficial_owners s důvody cycle a unknown.

Data počítáme ze seznamů společníků. Údaje o skutečných majitelích z Transparenzregister (rejstřík skutečných majitelů) nejsou od konce roku 2022 veřejně přístupné.

Majetkové účasti

Funkce shareholdings ukazuje opačný směr: ve kterých firmách má vyžádaná firma podíly. Účasti pocházejí ze seznamů společníků těchto firem. Stojí 5 kreditů, když existují účasti.

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

Pole
Pole	Význam	Příklad	Dostupnost
shareholdingsobject\|null	Firmy, ve kterých má vyžádaná firma podíly.Prázdné, když není známa žádná účast`shareholdings` · Beta	–	většinou: AG, SE, KGaA částečně: GmbH, UG zřídka: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Současné účasti, jedna na firmu.	–	jako výše
shareholdings.holdings.current[].organizationobject	Firma, ve které jsou podíly drženy.	–	jako výše
shareholdings.holdings.current[].organization.entity_idstring	ID firmy, pro její profil firmy.	`"63529c3a793e9f002196b4fd344e1241"`	jako výše
shareholdings.holdings.current[].organization.namestring\|null	Název firmy.	`"Hetzner Cloud GmbH"`	jako výše
shareholdings.holdings.current[].organization.legal_formstring\|null	Právní forma firmy.	`"GmbH"`	jako výše
shareholdings.holdings.current[].organization.statusstring\|null	Stav firmy v rejstříku, například ACTIVE.	`"ACTIVE"`	jako výše
shareholdings.holdings.current[].organization.addressobject\|array	Adresa firmy, strukturovaná jako address v základních údajích.Prázdné, když není známá žádná adresa; hodnota je pak prázdný seznam []	–	jako výše
shareholdings.holdings.current[].organization.registrationobject\|array	Zápis firmy v rejstříku s court, register_type a register_number.Prázdné, když není známý žádný zápis; hodnota je pak prázdný seznam []	–	jako výše
shareholdings.holdings.current[].ownership.percentagenumber\|null	Podíl v procentech: 100 znamená 100 %.Prázdné, když ze seznamu nevyplývá žádný podíl	`100`	jako výše
shareholdings.holdings.current[].ownership.contributionobject	Jmenovitá hodnota obchodních podílů s amount a currency.	–	jako výše
shareholdings.holdings.current[].as_ofstring	Datum seznamu společníků, ze kterého účast pochází.	`"2017-09-19"`	jako výše
shareholdings.summary.total_currentinteger	Počet současných účastí.	`2`	jako výše

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 · Ukázková odpověď: Hetzner Online GmbH s funkcí shareholdings

Účasti osoby jsou v profilu osoby, se stejnou funkcí.

Koncernové struktury

Koncernové vazby skládáš z více údajů. shareholders a shareholdings ukazují účasti o úroveň výš a níž, ubos osoby na konci řetězce.

Síť firmy propojuje firmy a osoby přes dvě úrovně. Zahrnuje i propojené firmy.

Fúze, rozdělení a další přeměny najdeš v části Fúze a akvizice.