Wspólnicy i udziały – Dokumentacja

Feature
Feature	Co zwraca	Kredyty	Dostępny
shareholders	Wspólnicy: obecni wspólnicy z udziałami i wcześniejsze listy wspólników	5	każde konto · Beta
shareholders_deep	Szczegółowe dane wspólników: posiadacze z numerami udziałów, od kiedy mają udziały i co zmieniło się ostatnio	80	Max
ubos	Beneficjenci rzeczywiści (UBO): osoby stojące za firmą, wyliczone z list wspólników	10	każde konto · Beta
shareholdings	Udziały: firmy, w których sama firma ma udziały	5	każde konto · Beta

Wspólnicy według formy prawnej

Co rejestr mówi o właścicielach, zależy od formy prawnej. Tabela pokazuje, co zwykle dostajesz.

Forma prawna
Forma prawna	Wspólnicy w odpowiedzi
GmbH, UG	Wszyscy wspólnicy z listy wspólników według § 40 GmbHG, z wartością nominalną i udziałem w Stammkapital (kapitał zakładowy), a także wcześniejsze listy.
AG, SE, KGaA	Tylko w pojedynczych przypadkach, bo akcjonariusze AG nie figurują w żadnym publicznym rejestrze.
GmbH & Co. KG	Komandytariusze (Kommanditisten) z rejestru z sumą komandytową, częściowo także GmbH jako komplementariusz.
KG, OHG	Wpisani wspólnicy: w KG komplementariusze (Komplementäre) i komandytariusze, w OHG wspólnicy osobiście odpowiedzialni.
e.K.	Właściciel.
eG	Brak. Lista członków spółdzielni nie jest publiczna.
PartG	Wpisani partnerzy.

Listy wspólników to często zeskanowane dokumenty w wielu układach. Wyodrębniamy je automatycznie. Używamy do tego najnowszej technologii i dużo inwestujemy w jakość; pojedyncze błędy są jednak możliwe.

Wspólnicy

Feature shareholders zwraca obecnych wspólników: w GmbH z najnowszej listy wspólników, w spółkach osobowych i u kupców jednoosobowych z rejestru. Kosztuje 5 kredytów, ale tylko gdy wymienia obecnych wspólników. Jeśli zwraca tylko wcześniejsze listy, nic nie kosztuje.

Każdy wpis w entries opisuje osobę lub firmę. Osoba ma first_name, last_name i birth_date, firma entity_name, country_code i registration_reference.

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

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholdersobject\|null	Wspólnicy firmy: obecny stan w entries, wcześniejsze stany w history.Puste, gdy nie są znani żadni wspólnicy, np. w AG lub eG`shareholders` · Beta	–	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders.entriesarray	Obecni wspólnicy, jeden wpis na osobę lub firmę.	–	jak wyżej
shareholders.entries[].shareholderobject	Kto ma udział: osoba lub firma, z polami poniżej.	–	jak wyżej
shareholders.entries[].shareholder.entity_idstring\|null	Identyfikator osoby lub firmy, do jej własnego profilu osoby lub profilu firmy.Puste, gdy wspólnika nie dało się pewnie dopasować	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	jak wyżej
shareholders.entries[].shareholder.first_namestring	Imię osoby, ze wszystkimi wpisanymi imionami.	–	zawsze: e.K. zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders.entries[].shareholder.last_namestring	Nazwisko osoby.	–	jak wyżej
shareholders.entries[].shareholder.birth_datestring\|null	Data urodzenia osoby, w formacie YYYY-MM-DD.Puste, gdy dokument nie podaje daty urodzenia	–	jak wyżej
shareholders.entries[].shareholder.entity_namestring	Nazwa firmy, która jest wspólnikiem.	`"ENSoXX GmbH"`	zwykle: GmbH, UG, GmbH & Co. KG rzadko: AG, SE, KGaA, KG, OHG nigdy: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Kraj firmy jako trzyliterowy kod ISO (ISO 3166-1 alpha-3), np. DEU.	`"DEU"`	jak wyżej
shareholders.entries[].shareholder.registration_referencestring\|null	Wpis firmy do rejestru jako tekst, tak jak stoi w dokumencie.Puste, gdy dokument nie podaje wpisu do rejestru, często przy firmach zagranicznych	`"AG Ansbach HRB 6105"`	jak wyżej
shareholders.entries[].shareholder.addressstring\|null	Adres, miejsce zamieszkania lub siedziba jako tekst, tak jak stoi w dokumencie.Puste, gdy dokument nie podaje adresu	`"Gunzenhausen"`	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders.entries[].contributionobject\|null	Wielkość udziału z amount i currency: w GmbH wartość nominalna udziałów, u komandytariuszy wpisana suma komandytowa (Haftsumme).Puste, gdy nie wpisano kwoty, np. u wspólników osobiście odpowiedzialnych lub właściciela e.K	–	zwykle: GmbH, UG, GmbH & Co. KG częściowo: KG, OHG rzadko: AG, SE, KGaA nigdy: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Udział w kapitale jako ułamek dziesiętny: 1 oznacza 100 %, 0.245 oznacza 24,5 %.Puste, gdy nie da się wyznaczyć udziału, np. w spółkach osobowych	`0.945`	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders.entries[].roleobject	Rola: label jako stały kod, a do tego de i en z nazwą długą i krótką, np. Kommanditist i Kom.	–	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders.entries[].role.labelstring	Rola jako stały kod. Mogą dojść nowe wartości.Wartości: `SHAREHOLDER` wspólnik według listy wspólników, `LIMITED_PARTNER` komandytariusz (Kommanditist), `FULLY_LIABLE_PARTNER` wspólnik osobiście odpowiedzialny (persönlich haftender Gesellschafter), `PARTNER` partner w PartG, `OWNER` właściciel e.K.	`"SHAREHOLDER"`	jak wyżej
shareholders.total_capitalobject\|null	Kapitał według listy wspólników, z amount i currency, podstawa dla contribution_ratio.Puste, gdy lista nie podaje kapitału, a także w spółkach osobowych	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG

Przez entity_id wspólnika pobierzesz jego własny profil firmy lub profil osoby. Tak śledzisz łańcuch własności poziom po poziomie.

Historia wspólników

shareholders.history jest bez dodatkowych kosztów. Zawiera datę obecnej listy i wcześniejsze listy wspólników, od najnowszej.

W KG lub GmbH & Co. KG byli wspólnicy są w register_ownership, z datami wejścia i wyjścia z rejestru. Dla OHG, PartG i e.K. znajdziesz ich w shareholders_deep.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholders.historyobject	Wcześniejsze stany wspólników, bez dodatkowych kosztów.Puste, gdy nie ma wcześniejszych stanów; pola wtedy brak, np. w OHG, PartG lub e.K`shareholders` · Beta	–	zwykle: GmbH, UG częściowo: GmbH & Co. KG, KG, OHG rzadko: AG, SE, KGaA nigdy: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Data listy wspólników, z której pochodzi entries.Puste, gdy wspólnicy pochodzą z rejestru	`"2015-08-21"`	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders.history.pastarray	Wcześniejsze listy wspólników, od najnowszej.Puste, gdy istnieje tylko jedna lista	–	jak wyżej
shareholders.history.past[].as_ofstring	Data tej listy wspólników.	`"2015-07-28"`	jak wyżej
shareholders.history.past[].data.total_capitalobject\|null	Kapitał według tej listy, z amount i currency. Starsze listy podają go częściowo w DEM.	–	jak wyżej
shareholders.history.past[].data.shareholdersarray	Wspólnicy według tej listy, z tymi samymi polami co entries.	–	jak wyżej
shareholders.history.register_ownershipobject	W KG i GmbH & Co. KG: byli wspólnicy według rejestru, w past.	–	częściowo: GmbH & Co. KG, KG, OHG nigdy: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Były wspólnik, z tymi samymi polami co w entries.	–	jak wyżej
shareholders.history.register_ownership.past[].roleobject	Jego rola, w tej samej strukturze co role w entries.	–	jak wyżej
shareholders.history.register_ownership.past[].effective_fromstring\|null	Od kiedy był wpisany, w formacie YYYY-MM-DD.	`"2022-01-07"`	jak wyżej
shareholders.history.register_ownership.past[].effective_tostring\|null	Do kiedy był wpisany.	`"2026-07-06"`	jak wyżej
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true, jeśli effective_to jest wywnioskowane, a nie wprost wpisane.	`false`	jak wyżej
shareholders.history.register_ownership.past[].contributionnull	Tutaj zawsze null.	–	jak wyżej
shareholders.history.register_ownership.past[].contribution_rationull	Tutaj zawsze null.	–	jak wyżej

Szczegółowe dane wspólników

Feature shareholders_deep jest dostępny w planie Max. Kosztuje 80 kredytów, ale tylko gdy obecny dokument wymienia co najmniej jednego posiadacza.

Czyta wszystkie listy wspólników firmy, nie tylko najnowszą. Dzięki temu pokazuje, od kiedy ktoś ma udziały, jak wyglądały wcześniejsze stany i co zmieniła ostatnia lista.

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

Dokument. record mówi, skąd pochodzi obecny stan, share_capital podaje kapitał według tego dokumentu.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholders_deepobject\|null	Posiadacze, udziały, wcześniejsze dokumenty i ostatnia zmiana.Puste, gdy nie jest znany obecny dokument ani wpisany wspólnik, typowe dla AG, SE i eG`shareholders_deep` · od Max	–	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.recordobject	Dokument, z którego pochodzi obecny stan: data i źródło.	–	jak wyżej
shareholders_deep.record.datestring\|null	Data, do której odnosi się dokument. Zwykle krótko po zmianie, którą pokazuje dokument.Puste, gdy wspólnicy pochodzą z rejestru (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.record.sourcestring	Rodzaj dokumentu.Wartości: `SHAREHOLDER_LIST` lista wspólników (Gesellschafterliste), `FOUNDING_DOCUMENT` dokument założycielski, czyli Musterprotokoll (protokół wzorcowy) lub Gesellschaftsvertrag (umowa spółki), `COMMERCIAL_REGISTER` wspólnicy lub właściciele wpisani do rejestru	`"SHAREHOLDER_LIST"`	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.share_capitalobject\|null	Kapitał według dokumentu: value, currency i basis.Puste, gdy dokument nie podaje kapitału, a zawsze przy COMMERCIAL_REGISTER	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Skąd pochodzi kwota.Wartości: `REPORTED` podana w dokumencie, `CALCULATED` wyliczona z liczby i wartości nominalnej udziałów	`"REPORTED"`	jak wyżej

Posiadacze. Każdy wpis w entries to jeden wiersz dokumentu, największy udział najpierw. Jeśli ktoś ma kilka wierszy, pojawia się na liście kilka razy.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholders_deep.entriesarray	Obecni posiadacze, jeden wiersz dokumentu na wpis, największy udział najpierw.`shareholders_deep` · od Max	–	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.entries[].holderobject	Kto ma udział. type określa, jakie pola następują.	–	jak wyżej
shareholders_deep.entries[].holder.typestring	Rodzaj posiadacza.Wartości: `ORGANIZATION` firma lub inna organizacja, `PERSON` osoba fizyczna, `JOINT` udział współposiadany, np. przez wspólnotę spadkową, z members	`"ORGANIZATION"`	jak wyżej
shareholders_deep.entries[].holder.entity_idstring\|null	Identyfikator posiadacza, do jego własnego profilu firmy lub profilu osoby.Puste, gdy posiadacza nie dało się pewnie dopasować, a zawsze przy JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	jak wyżej
shareholders_deep.entries[].holder.namestring	Nazwa. U dopasowanych posiadaczy aktualna nazwa, w innych przypadkach jak w dokumencie.	`"ENSoXX GmbH"`	jak wyżej
shareholders_deep.entries[].holder.birth_datestring\|null	Tylko u osób: data urodzenia.Puste, gdy dokument jej nie podaje	–	zawsze: e.K. zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Tylko u organizacji: forma prawna jako tekst, np. GmbH lub Ltd.	`"GmbH"`	zwykle: GmbH, UG, GmbH & Co. KG rzadko: AG, SE, KGaA, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Tylko u organizacji: obecny status w rejestrze.Puste, gdy posiadacz nie jest dopasowany, a zawsze we wcześniejszych dokumentach w historyWartości: `ACTIVE` aktywna, `INACTIVE` już nieaktywna, np. wykreślona lub połączona	`"ACTIVE"`	jak wyżej
shareholders_deep.entries[].holder.citystring\|null	Siedziba lub miejsce zamieszkania.	`"Gunzenhausen"`	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.entries[].holder.countrystring\|null	Kraj jako trzyliterowy kod ISO (ISO 3166-1 alpha-3), np. DEU, AUT lub LUX.	`"DEU"`	jak wyżej
shareholders_deep.entries[].holder.registrationobject\|null	Tylko u organizacji: court, register_type i register_number.Puste, gdy nie da się odczytać wpisu do rejestru, np. u wielu firm zagranicznych	–	zwykle: GmbH, UG, GmbH & Co. KG rzadko: AG, SE, KGaA, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Tylko u organizacji: wpis do rejestru jako tekst, gdy brak registration lub nie podaje ono sądu.	`null`	rzadko
shareholders_deep.entries[].rolestring	Rola posiadacza. Mogą dojść nowe wartości.Wartości: `SHAREHOLDER` wspólnik według listy wspólników lub dokumentu założycielskiego, `LIMITED_PARTNER` komandytariusz (Kommanditist), `FULLY_LIABLE_PARTNER` wspólnik osobiście odpowiedzialny (persönlich haftender Gesellschafter), `PARTNER` partner w PartG, `OWNER` właściciel e.K.	`"SHAREHOLDER"`	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.entries[].sincestring\|null	Od kiedy posiadacz ma udziały. U wpisanych wspólników data wpisu.Puste, gdy nie da się ustalić daty, a zawsze przy JOINT	`"2015-08-18"`	jak wyżej
shareholders_deep.entries[].since_basisstring\|null	Na ile pewne jest since.Wartości: `ENTRY_RECORDED` udokumentowane od tej daty: poprzednia lista jeszcze nie wymienia posiadacza, `EARLIEST_RECORD` już w najstarszym dostępnym dokumencie, więc wspólnik co najmniej od tej daty	`"ENTRY_RECORDED"`	jak wyżej

Udział. ownership opisuje, ile ma posiadacz: w procentach, jako wartość nominalną i według kolejnych numerów udziałów.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholders_deep.entries[].ownershipobject	Udział posiadacza.`shareholders_deep` · od Max	–	zwykle: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rzadko: AG, SE, KGaA nigdy: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Udział w kapitale w procentach, od 0 do 100. To bezpośredni udział, nie prawa głosu.Puste, gdy udziału nie da się wiarygodnie ustalić, a zawsze u wpisanych wspólników spółek osobowych	`94.5`	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Skąd pochodzi percentage.Wartości: `REPORTED` podany w dokumencie lub wyprowadzony z wartości nominalnej i kapitału w dokumencie, `CALCULATED` wyliczony z liczby i wartości nominalnej udziałów	`"REPORTED"`	jak wyżej
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Suma wartości nominalnych z value i currency. U komandytariuszy wpisana suma komandytowa (Haftsumme).Puste, gdy kwota nie jest znana	–	zwykle: GmbH, UG, GmbH & Co. KG częściowo: KG, OHG rzadko: AG, SE, KGaA nigdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Liczba udziałów (Geschäftsanteile).Puste, gdy liczba nie jest znana dla wszystkich udziałów	`47250`	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Udziały według kolejnych numerów na liście, jeden zakres na ciąg jednakowych udziałów.	–	jak wyżej
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Pierwszy numer kolejny zakresu.	`1`	jak wyżej
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Ostatni numer kolejny zakresu.	`47250`	jak wyżej
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Liczba udziałów w zakresie.	`47250`	jak wyżej
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Wartość nominalna jednego udziału w zakresie, z value i currency.	–	jak wyżej

Historia i zmiany. history zawiera wcześniejsze dokumenty z tymi samymi polami. Posiadacze występują tam tak, jak stali w ówczesnym dokumencie. changes porównuje obecny stan z poprzednim.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholders_deep.historyarray	Wcześniejsze dokumenty, od najnowszego, każdy z record, share_capital i entries. Byli wpisani wspólnicy są zebrani w ostatnim wpisie.`shareholders_deep` · od Max	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	Przy JOINT: współposiadacze typu PERSON lub ORGANIZATION, z tymi samymi polami co holder.	–	rzadko
shareholders_deep.history[].entries[].untilstring\|null	Tylko w pozycji history z COMMERCIAL_REGISTER: kiedy wspólnik odszedł.	–	częściowo: GmbH & Co. KG, KG, OHG, PartG rzadko: e.K. nigdy: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Co zmieniło się w obecnym dokumencie w porównaniu z poprzednim.Puste, gdy nie ma wcześniejszego dokumentu, a także gdy obecny stan pochodzi z rejestru lub dokumentu założycielskiego	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Data poprzedniego dokumentu.	`"2015-07-16"`	jak wyżej
shareholders_deep.changes.joinedarray	Nowi posiadacze: holder z entity_id, type i name, a także percentage.	–	jak wyżej
shareholders_deep.changes.leftarray	Posiadacze, którzy odeszli, z ostatnio posiadanym udziałem.	–	jak wyżej
shareholders_deep.changes.changedarray	Posiadacze, których udział się zmienił.	–	jak wyżej
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Udział w procentach w poprzednim dokumencie.	`100`	jak wyżej
shareholders_deep.changes.changed[].percentage_afternumber\|null	Udział w procentach w obecnym dokumencie.	`5.5`	jak wyżej

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 · Przykładowa odpowiedź: Hetzner Online GmbH z feature shareholders_deep

W porównaniu z shareholders, shareholders_deep dodaje numery udziałów, datę, od której ktoś ma udziały, zmiany oraz udziały współposiadane z ich członkami. Do porównań między firmami i latami najlepiej konsekwentnie używać tego samego feature.

Beneficjenci rzeczywiści

Beneficjenci rzeczywiści to osoby fizyczne, do których ostatecznie należy firma. Feature ubos śledzi listy wspólników przez kolejne poziomy własności aż do osób. Lista wymienia każdą osobę z wyliczonym udziałem, bez progu minimalnego. Kosztuje 10 kredytów, gdy zwraca dane.

Jeśli udziału nie da się przypisać osobie, jest w unresolved_beneficial_owners z przyczyną. Często ma go firma za granicą. Nasze dane obejmują niemieckie firmy, więc nie znamy wspólników firmy zagranicznej. coverage pokazuje, jaki procent kapitału przypisano osobom, a ile pozostaje otwarte. Obie wartości nie zawsze sumują się do 100. Dla reszty dane o wspólnikach nie wymieniają posiadacza.

Feature jest naliczany, gdy tylko zwróci wynik. Dotyczy to także sytuacji, gdy wszystkie udziały są w unresolved_beneficial_owners.

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

Pole
Pole	Znaczenie	Przykład	Dostępność
ubosobject\|null	Beneficjenci rzeczywiści, wyliczeni z list wspólników przez kolejne poziomy własności.Puste, gdy z list wspólników nie da się zbudować łańcucha, np. w AG, eG lub e.K`ubos` · Beta	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
ubos.beneficial_ownersarray	Osoby, do których firma należy bezpośrednio lub przez inne firmy.Puste, gdy żadnego udziału nie da się przypisać osobie	–	jak wyżej
ubos.beneficial_owners[].personobject	Osoba, z polami poniżej.	–	częściowo: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	Identyfikator osoby, do profilu osoby.Puste, gdy osoby nie dało się pewnie dopasować	–	jak wyżej
ubos.beneficial_owners[].person.namestring	Pełne imię i nazwisko.	–	jak wyżej
ubos.beneficial_owners[].person.name_partsobject	Imię i nazwisko w częściach: given i family, a także canonical_name, jeśli znane.	–	jak wyżej
ubos.beneficial_owners[].person.birth_datestring\|null	Data urodzenia.	–	jak wyżej
ubos.beneficial_owners[].person.locationobject\|null	Miejsce zamieszkania w home: city, county, state i country.Puste, gdy miejsce zamieszkania nie jest znane	–	jak wyżej
ubos.beneficial_owners[].ownership_percentagenumber	Łączny udział osoby w procentach, zsumowany po wszystkich ścieżkach.	`50`	jak wyżej
ubos.beneficial_owners[].pathsarray	Każda ścieżka do osoby, z udziałem wzdłuż tej ścieżki.	–	jak wyżej
ubos.beneficial_owners[].paths[].percentagenumber	Udział w procentach, który dociera tą ścieżką.	`50`	jak wyżej
ubos.beneficial_owners[].paths[].viaarray	Firmy na tej ścieżce, najpierw bezpośredni wspólnik zapytanej firmy (depth 1). Pola są takie same jak w via nierozwiązanych udziałów.Puste, gdy osoba ma udziały bezpośrednio	–	jak wyżej

Pole
Pole	Znaczenie	Przykład	Dostępność
ubos.unresolved_beneficial_ownersarray	Udziały, których nie dało się przypisać osobie.Puste, gdy wszystkie udziały są rozwiązane`ubos` · Beta	–	zwykle: GmbH, UG rzadko: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nigdy: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Dlaczego łańcuch kończy się tutaj. Mogą dojść nowe wartości.Wartości: `unlinked` wspólnik to firma, której nie możemy dopasować do wpisu w niemieckim rejestrze, zwykle firma zagraniczna. Nie znamy jej wspólników, więc łańcuch kończy się tutaj, `no_further_shareholder_data` wspólnik to znana nam niemiecka firma, ale nie istnieje dla niej lista wspólników, np. KG, `cycle` łańcuch prowadzi z powrotem do firmy, która już w nim jest, np. gdy firma ma własne udziały, `unknown` o wspólniku nic nie wiadomo, ani nazwy, ani udziału	`"cycle"`	jak wyżej
ubos.unresolved_beneficial_owners[].namestring\|null	Nazwa wspólnika, na którym kończy się łańcuch.Puste, gdy przyczyna to unknown	`"ENSoXX Holding AG"`	jak wyżej
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Jego identyfikator, do jego własnego profilu firmy.Puste, gdy wspólnik nie jest dopasowany do firmy w naszych danych, czyli przy przyczynach unlinked i unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	jak wyżej
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Jego forma prawna.	`"AG"`	jak wyżej
ubos.unresolved_beneficial_owners[].addressobject\|array	Jego adres ze street, house_number, postal_code, city, county, state, country i coordinates.Puste, gdy adres nie jest znany; wartość to wtedy pusta lista []	–	jak wyżej
ubos.unresolved_beneficial_owners[].registrationobject\|array	Jego wpis do rejestru z court, register_type i register_number, także z rejestrów zagranicznych.Puste, gdy wpis nie jest znany; wartość to wtedy pusta lista []	–	jak wyżej
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Nierozwiązany udział w procentach, przeliczony aż do zapytanej firmy. Może wynosić 0.	`0`	jak wyżej
ubos.unresolved_beneficial_owners[].viaarray	Firmy, przez które łańcuch biegnie do tego miejsca, najpierw bezpośredni wspólnik zapytanej firmy.Puste, gdy nierozwiązany udział jest bezpośrednio w zapytanej firmie	–	jak wyżej
ubos.unresolved_beneficial_owners[].via[].depthinteger	Poziom: 1 to bezpośredni wspólnik zapytanej firmy. Obok są name i entity_id firmy.	`1`	jak wyżej
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Udział w procentach na tym poziomie.	`94.5`	jak wyżej
ubos.coverageobject	Ile kapitału przypisano osobom, a ile pozostaje otwarte. Obie wartości nie zawsze sumują się do 100.	–	jak wyżej
ubos.coverage.resolved_percentagenumber	Przypisane osobom, w procentach.	`5.5`	jak wyżej
ubos.coverage.unresolved_percentagenumber	Nieprzypisane osobom, w procentach.	`0`	jak wyżej

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 · Przykładowa odpowiedź: Hetzner Online GmbH z feature ubos. W naszym przykładowym zapytaniu jedna osoba była w beneficial_owners z udziałem 5,5%. Łańcuch przez ENSoXX GmbH, Ansbach HRB 6105, zakończył się w unresolved_beneficial_owners z przyczynami cycle i unknown.

Dane wyliczamy z list wspólników. Dane o beneficjentach rzeczywistych z Transparenzregister (rejestr przejrzystości) nie są publicznie dostępne od końca 2022 roku.

Udziały

Feature shareholdings pokazuje kierunek odwrotny: w jakich firmach zapytana firma ma udziały. Udziały pochodzą z list wspólników tych firm. Kosztuje 5 kredytów, gdy istnieją udziały.

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

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholdingsobject\|null	Firmy, w których zapytana firma ma udziały.Puste, gdy nie jest znany żaden udział`shareholdings` · Beta	–	zwykle: AG, SE, KGaA częściowo: GmbH, UG rzadko: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Obecne udziały, jeden na firmę.	–	jak wyżej
shareholdings.holdings.current[].organizationobject	Firma, w której są udziały.	–	jak wyżej
shareholdings.holdings.current[].organization.entity_idstring	Identyfikator firmy, do jej profilu firmy.	`"63529c3a793e9f002196b4fd344e1241"`	jak wyżej
shareholdings.holdings.current[].organization.namestring\|null	Nazwa firmy.	`"Hetzner Cloud GmbH"`	jak wyżej
shareholdings.holdings.current[].organization.legal_formstring\|null	Forma prawna firmy.	`"GmbH"`	jak wyżej
shareholdings.holdings.current[].organization.statusstring\|null	Status firmy w rejestrze, np. ACTIVE.	`"ACTIVE"`	jak wyżej
shareholdings.holdings.current[].organization.addressobject\|array	Adres firmy, w tej samej strukturze co address w danych podstawowych.Puste, gdy adres nie jest znany; wartość to wtedy pusta lista []	–	jak wyżej
shareholdings.holdings.current[].organization.registrationobject\|array	Wpis firmy do rejestru z court, register_type i register_number.Puste, gdy wpis nie jest znany; wartość to wtedy pusta lista []	–	jak wyżej
shareholdings.holdings.current[].ownership.percentagenumber\|null	Udział w procentach: 100 oznacza 100 %.Puste, gdy z listy nie wynika udział	`100`	jak wyżej
shareholdings.holdings.current[].ownership.contributionobject	Wartość nominalna udziałów z amount i currency.	–	jak wyżej
shareholdings.holdings.current[].as_ofstring	Data listy wspólników, z której pochodzi udział.	`"2017-09-19"`	jak wyżej
shareholdings.summary.total_currentinteger	Liczba obecnych udziałów.	`2`	jak wyżej

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 · Przykładowa odpowiedź: Hetzner Online GmbH z feature shareholdings

Udziały osoby są w profilu osoby, z tym samym feature.

Struktury grupy

Powiązania w grupie składasz z kilku danych. shareholders i shareholdings pokazują udziały o jeden poziom w górę i w dół, ubos osoby na końcu łańcucha.

Sieć powiązań firmy łączy firmy i osoby na dwóch poziomach. Obejmuje też firmy powiązane.

Połączenia, podziały i inne przekształcenia opisuje Fuzje i przejęcia.