Asociați și participații – Documentație

Funcție
Funcție	Ce returnează	Credite	Disponibil
shareholders	Asociați: asociații actuali cu cotele lor și listele anterioare ale asociaților	5	orice cont · Beta
shareholders_deep	Asociați detaliat: deținători cu numerele părților sociale, de când dețin părți și ce s-a schimbat ultima dată	80	Max
ubos	Beneficiari reali (UBO): persoanele din spatele companiei, calculate din listele asociaților	10	orice cont · Beta
shareholdings	Participații: companiile la care compania însăși deține părți	5	orice cont · Beta

Asociați după forma juridică

Ce spune registrul despre proprietari depinde de forma juridică. Tabelul arată ce primești de obicei.

Formă juridică
Formă juridică	Asociați în răspuns
GmbH, UG	Toți asociații din lista asociaților conform § 40 GmbHG, cu valoarea nominală și cota din capitalul social (Stammkapital), plus listele anterioare.
AG, SE, KGaA	Doar în cazuri izolate, pentru că acționarii unui AG nu apar în niciun registru public.
GmbH & Co. KG	Comanditarii (Kommanditisten) din registru cu suma lor de răspundere, parțial și GmbH-ul asociat cu răspundere nelimitată.
KG, OHG	Asociații înscriși: la un KG asociații cu răspundere nelimitată (Komplementäre) și comanditarii, la un OHG asociații cu răspundere personală.
e.K.	Proprietarul.
eG	Niciunul. Lista membrilor unei cooperative nu este publică.
PartG	Partenerii înscriși.

Listele asociaților sunt adesea documente scanate, în multe formate. Le extragem automat. Folosim pentru asta cea mai nouă tehnologie și investim mult în calitate; erori izolate sunt totuși posibile.

Asociați

Funcția shareholders returnează asociații actuali: la un GmbH din cea mai nouă listă a asociaților, la societățile de persoane și comercianții individuali din registru. Costă 5 credite, dar doar când numește asociați actuali. Dacă returnează doar liste anterioare, nu costă nimic.

Fiecare intrare din entries descrie o persoană sau o companie. O persoană are first_name, last_name și birth_date, o companie entity_name, country_code și registration_reference.

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

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholdersobject\|null	Asociații companiei: starea actuală în entries, stările anterioare în history.Gol când nu se cunosc asociați, de exemplu la un AG sau eG`shareholders` · Beta	–	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders.entriesarray	Asociații actuali, câte o intrare per persoană sau companie.	–	ca mai sus
shareholders.entries[].shareholderobject	Cine deține cota: o persoană sau o companie, cu câmpurile de mai jos.	–	ca mai sus
shareholders.entries[].shareholder.entity_idstring\|null	ID-ul persoanei sau companiei, pentru propriul ei profil de persoană sau de companie.Gol când asociatul nu a putut fi potrivit sigur	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	ca mai sus
shareholders.entries[].shareholder.first_namestring	Prenumele unei persoane, cu toate prenumele înregistrate.	–	întotdeauna: e.K. de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG rar: AG, SE, KGaA niciodată: eG
shareholders.entries[].shareholder.last_namestring	Numele de familie al unei persoane.	–	ca mai sus
shareholders.entries[].shareholder.birth_datestring\|null	Data nașterii unei persoane, în formatul YYYY-MM-DD.Gol când documentul nu indică data nașterii	–	ca mai sus
shareholders.entries[].shareholder.entity_namestring	Denumirea unei companii care este asociat.	`"ENSoXX GmbH"`	de obicei: GmbH, UG, GmbH & Co. KG rar: AG, SE, KGaA, KG, OHG niciodată: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Țara unei companii ca cod ISO din trei litere (ISO 3166-1 alpha-3), de exemplu DEU.	`"DEU"`	ca mai sus
shareholders.entries[].shareholder.registration_referencestring\|null	Înscrierea în registru a unei companii ca text, așa cum apare în document.Gol când documentul nu indică înscrierea în registru, adesea la companiile străine	`"AG Ansbach HRB 6105"`	ca mai sus
shareholders.entries[].shareholder.addressstring\|null	Adresa, domiciliul sau sediul ca text, așa cum apare în document.Gol când documentul nu indică adresa	`"Gunzenhausen"`	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders.entries[].contributionobject\|null	Valoarea participației cu amount și currency: la un GmbH valoarea nominală a părților sociale, la comanditari suma de răspundere înregistrată (Haftsumme).Gol când nu este înregistrată nicio sumă, de exemplu la asociații cu răspundere personală sau la proprietarul unui e.K	–	de obicei: GmbH, UG, GmbH & Co. KG parțial: KG, OHG rar: AG, SE, KGaA niciodată: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Cota din capital ca număr zecimal: 1 înseamnă 100 %, 0.245 înseamnă 24,5 %.Gol când nu se poate deduce nicio cotă, de exemplu la societățile de persoane	`0.945`	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders.entries[].roleobject	Rolul: label ca cod fix, plus de și en cu o denumire lungă și una scurtă, de exemplu Kommanditist și Kom.	–	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders.entries[].role.labelstring	Rolul ca cod fix. Se pot adăuga valori noi.Valori: `SHAREHOLDER` asociat conform listei asociaților, `LIMITED_PARTNER` comanditar (Kommanditist), `FULLY_LIABLE_PARTNER` asociat cu răspundere personală (persönlich haftender Gesellschafter), `PARTNER` partener al unui PartG, `OWNER` proprietarul unui e.K.	`"SHAREHOLDER"`	ca mai sus
shareholders.total_capitalobject\|null	Capitalul conform listei asociaților, cu amount și currency, baza pentru contribution_ratio.Gol când lista nu indică capitalul, precum și la societățile de persoane	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG

Cu entity_id-ul unui asociat preiei propriul lui profil de companie sau de persoană. Așa urmărești un lanț de proprietate nivel cu nivel.

Istoricul asociaților

shareholders.history vine fără cost suplimentar. Conține data listei actuale și listele anterioare ale asociaților, cele mai noi primele.

La un KG sau GmbH & Co. KG, foștii asociați se află în register_ownership, cu datele de intrare și ieșire din registru. La OHG, PartG și e.K. îi găsești în shareholders_deep.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholders.historyobject	Stări anterioare ale asociaților, fără cost suplimentar.Gol când nu există stări anterioare; câmpul lipsește atunci, de exemplu la OHG, PartG sau e.K`shareholders` · Beta	–	de obicei: GmbH, UG parțial: GmbH & Co. KG, KG, OHG rar: AG, SE, KGaA niciodată: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Data listei asociaților din care provine entries.Gol când asociații provin din registru	`"2015-08-21"`	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders.history.pastarray	Listele anterioare ale asociaților, cele mai noi primele.Gol când există o singură listă	–	ca mai sus
shareholders.history.past[].as_ofstring	Data acestei liste a asociaților.	`"2015-07-28"`	ca mai sus
shareholders.history.past[].data.total_capitalobject\|null	Capitalul conform acestei liste, cu amount și currency. Listele mai vechi îl indică parțial în DEM.	–	ca mai sus
shareholders.history.past[].data.shareholdersarray	Asociații conform acestei liste, cu aceleași câmpuri ca entries.	–	ca mai sus
shareholders.history.register_ownershipobject	La KG și GmbH & Co. KG: foștii asociați conform registrului, în past.	–	parțial: GmbH & Co. KG, KG, OHG niciodată: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Fostul asociat, cu aceleași câmpuri ca în entries.	–	ca mai sus
shareholders.history.register_ownership.past[].roleobject	Rolul său, structurat ca role în entries.	–	ca mai sus
shareholders.history.register_ownership.past[].effective_fromstring\|null	De când a fost înscris, în formatul YYYY-MM-DD.	`"2022-01-07"`	ca mai sus
shareholders.history.register_ownership.past[].effective_tostring\|null	Până când a fost înscris.	`"2026-07-06"`	ca mai sus
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true dacă effective_to este dedus și nu înscris explicit.	`false`	ca mai sus
shareholders.history.register_ownership.past[].contributionnull	Aici întotdeauna null.	–	ca mai sus
shareholders.history.register_ownership.past[].contribution_rationull	Aici întotdeauna null.	–	ca mai sus

Asociați detaliat

Funcția shareholders_deep vine cu planul Max. Costă 80 de credite, dar doar când documentul actual numește cel puțin un deținător.

Citește toate listele asociaților unei companii, nu doar pe cea mai nouă. Astfel arată de când deține cineva părți, cum arătau stările anterioare și ce a schimbat ultima listă.

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

Documentul. record spune de unde provine starea actuală, share_capital indică capitalul conform acelui document.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholders_deepobject\|null	Deținători, cote, documente anterioare și ultima modificare.Gol când nu se cunoaște niciun document actual și niciun asociat înscris, tipic pentru AG, SE și eG`shareholders_deep` · de la Max	–	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.recordobject	Documentul din care provine starea actuală: dată și sursă.	–	ca mai sus
shareholders_deep.record.datestring\|null	Data la care se referă documentul. De obicei este la scurt timp după modificarea pe care o arată documentul.Gol când asociații provin din registru (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.record.sourcestring	Tipul documentului.Valori: `SHAREHOLDER_LIST` lista asociaților (Gesellschafterliste), `FOUNDING_DOCUMENT` act de înființare, adică Musterprotokoll (proces-verbal tip) sau Gesellschaftsvertrag (act constitutiv), `COMMERCIAL_REGISTER` asociați sau proprietari înscriși în registru	`"SHAREHOLDER_LIST"`	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.share_capitalobject\|null	Capitalul conform documentului: value, currency și basis.Gol când documentul nu indică capitalul, și întotdeauna la COMMERCIAL_REGISTER	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	De unde provine suma.Valori: `REPORTED` indicată în document, `CALCULATED` calculată din numărul și valoarea nominală a părților sociale	`"REPORTED"`	ca mai sus

Deținătorii. Fiecare intrare din entries este un rând al documentului, cea mai mare cotă prima. Dacă cineva are mai multe rânduri, apare de mai multe ori în listă.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholders_deep.entriesarray	Deținătorii actuali, câte un rând al documentului per intrare, cea mai mare cotă prima.`shareholders_deep` · de la Max	–	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.entries[].holderobject	Cine deține cota. type determină ce câmpuri urmează.	–	ca mai sus
shareholders_deep.entries[].holder.typestring	Tipul deținătorului.Valori: `ORGANIZATION` companie sau altă organizație, `PERSON` persoană fizică, `JOINT` cotă deținută în comun, de exemplu de o comunitate de moștenitori, cu members	`"ORGANIZATION"`	ca mai sus
shareholders_deep.entries[].holder.entity_idstring\|null	ID-ul deținătorului, pentru propriul profil de companie sau de persoană.Gol când deținătorul nu a putut fi potrivit sigur, și întotdeauna la JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	ca mai sus
shareholders_deep.entries[].holder.namestring	Numele. La deținătorii potriviți numele actual, altfel ca în document.	`"ENSoXX GmbH"`	ca mai sus
shareholders_deep.entries[].holder.birth_datestring\|null	Doar la persoane: data nașterii.Gol când documentul nu indică niciuna	–	întotdeauna: e.K. de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Doar la organizații: forma juridică ca text, de exemplu GmbH sau Ltd.	`"GmbH"`	de obicei: GmbH, UG, GmbH & Co. KG rar: AG, SE, KGaA, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Doar la organizații: statusul actual în registru.Gol când deținătorul nu este potrivit, și întotdeauna în documentele anterioare din historyValori: `ACTIVE` activă, `INACTIVE` nu mai este activă, de exemplu radiată sau fuzionată	`"ACTIVE"`	ca mai sus
shareholders_deep.entries[].holder.citystring\|null	Sediul sau domiciliul.	`"Gunzenhausen"`	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.entries[].holder.countrystring\|null	Țara ca cod ISO din trei litere (ISO 3166-1 alpha-3), de exemplu DEU, AUT sau LUX.	`"DEU"`	ca mai sus
shareholders_deep.entries[].holder.registrationobject\|null	Doar la organizații: court, register_type și register_number.Gol când nu se poate citi nicio înscriere în registru, de exemplu la multe companii străine	–	de obicei: GmbH, UG, GmbH & Co. KG rar: AG, SE, KGaA, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Doar la organizații: înscrierea în registru ca text, când registration lipsește sau nu numește nicio instanță.	`null`	rar
shareholders_deep.entries[].rolestring	Rolul deținătorului. Se pot adăuga valori noi.Valori: `SHAREHOLDER` asociat conform listei asociaților sau actului de înființare, `LIMITED_PARTNER` comanditar (Kommanditist), `FULLY_LIABLE_PARTNER` asociat cu răspundere personală (persönlich haftender Gesellschafter), `PARTNER` partener al unui PartG, `OWNER` proprietarul unui e.K.	`"SHAREHOLDER"`	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.entries[].sincestring\|null	De când deține deținătorul părți. La asociații înscriși, data înscrierii.Gol când nu se poate determina nicio dată, și întotdeauna la JOINT	`"2015-08-18"`	ca mai sus
shareholders_deep.entries[].since_basisstring\|null	Cât de sigur este since.Valori: `ENTRY_RECORDED` documentat de la această dată: lista anterioară nu numește încă deținătorul, `EARLIEST_RECORD` apare deja în cel mai vechi document disponibil, deci asociat cel puțin de la această dată	`"ENTRY_RECORDED"`	ca mai sus

Cota. ownership descrie cât deține un deținător: în procente, ca valoare nominală și după numerele de ordine ale părților sociale.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholders_deep.entries[].ownershipobject	Cota deținătorului.`shareholders_deep` · de la Max	–	de obicei: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG rar: AG, SE, KGaA niciodată: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Cota din capital în procente, de la 0 la 100. Este participația directă, nu drepturile de vot.Gol când cota nu poate fi determinată sigur, și întotdeauna la asociații înscriși ai societăților de persoane	`94.5`	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	De unde provine percentage.Valori: `REPORTED` indicat în document sau dedus din valoarea nominală și capitalul din document, `CALCULATED` calculat din numărul și valoarea nominală a părților sociale	`"REPORTED"`	ca mai sus
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Suma valorilor nominale cu value și currency. La comanditari, suma de răspundere înregistrată (Haftsumme).Gol când nu se cunoaște nicio sumă	–	de obicei: GmbH, UG, GmbH & Co. KG parțial: KG, OHG rar: AG, SE, KGaA niciodată: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Numărul părților sociale (Geschäftsanteile).Gol când numărul nu este cunoscut pentru toate părțile	`47250`	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Părțile sociale după numerele lor de ordine din listă, câte un interval per serie de părți egale.	–	ca mai sus
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Primul număr de ordine al intervalului.	`1`	ca mai sus
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Ultimul număr de ordine al intervalului.	`47250`	ca mai sus
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Numărul de părți din interval.	`47250`	ca mai sus
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Valoarea nominală per parte din interval, cu value și currency.	–	ca mai sus

Istoric și modificări. history conține documentele anterioare cu aceleași câmpuri. Deținătorii apar acolo așa cum figurau în documentul de atunci. changes compară starea actuală cu cea anterioară.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholders_deep.historyarray	Documentele anterioare, cele mai noi primele, fiecare cu record, share_capital și entries. Foștii asociați înscriși sunt adunați în ultima intrare.`shareholders_deep` · de la Max	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	La JOINT: codeținătorii de tipul PERSON sau ORGANIZATION, cu aceleași câmpuri ca holder.	–	rar
shareholders_deep.history[].entries[].untilstring\|null	Doar în elementul din history cu COMMERCIAL_REGISTER: când a ieșit asociatul.	–	parțial: GmbH & Co. KG, KG, OHG, PartG rar: e.K. niciodată: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Ce s-a schimbat cu documentul actual față de cel anterior.Gol când nu există un document anterior, precum și când starea actuală provine din registru sau dintr-un act de înființare	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Data documentului anterior.	`"2015-07-16"`	ca mai sus
shareholders_deep.changes.joinedarray	Deținători noi: holder cu entity_id, type și name, plus percentage.	–	ca mai sus
shareholders_deep.changes.leftarray	Deținători care au ieșit, cu cota pe care au avut-o ultima dată.	–	ca mai sus
shareholders_deep.changes.changedarray	Deținători a căror cotă s-a schimbat.	–	ca mai sus
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Cota în procente în documentul anterior.	`100`	ca mai sus
shareholders_deep.changes.changed[].percentage_afternumber\|null	Cota în procente în documentul actual.	`5.5`	ca mai sus

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 · Răspuns exemplu: Hetzner Online GmbH cu funcția shareholders_deep

Față de shareholders, shareholders_deep adaugă numerele părților sociale, data de la care cineva deține părți, modificările și părțile deținute în comun cu membrii lor. Pentru comparații între companii și ani, cel mai bine folosești aceeași funcție peste tot.

Beneficiari reali

Beneficiarii reali sunt persoanele fizice cărora le aparține în final o companie. Funcția ubos urmează listele asociaților peste nivelurile de proprietate până la persoane. Lista numește fiecare persoană cu o cotă calculată, fără prag minim. Costă 10 credite când returnează date.

Dacă o cotă nu poate fi urmărită până la o persoană, se află în unresolved_beneficial_owners cu motivul. Adesea o deține o companie din străinătate. Datele noastre acoperă companiile germane, deci nu cunoaștem asociații unei companii din străinătate. coverage arată ce procent din capital este urmărit până la persoane și cât rămâne deschis. Cele două valori nu dau întotdeauna 100 împreună. Pentru rest, datele despre asociați nu numesc niciun deținător.

Funcția se taxează de îndată ce returnează un rezultat. Asta se aplică și când toate cotele se află în unresolved_beneficial_owners.

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

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
ubosobject\|null	Beneficiarii reali, calculați din listele asociaților peste nivelurile de proprietate.Gol când nu se poate construi niciun lanț din listele asociaților, de exemplu la AG, eG sau e.K`ubos` · Beta	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
ubos.beneficial_ownersarray	Persoanele cărora le aparține compania direct sau prin alte companii.Gol când nicio cotă nu poate fi urmărită până la o persoană	–	ca mai sus
ubos.beneficial_owners[].personobject	Persoana, cu câmpurile de mai jos.	–	parțial: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID-ul persoanei, pentru profilul de persoană.Gol când persoana nu a putut fi potrivită sigur	–	ca mai sus
ubos.beneficial_owners[].person.namestring	Numele complet.	–	ca mai sus
ubos.beneficial_owners[].person.name_partsobject	Numele în părți: given și family, plus canonical_name când e cunoscut.	–	ca mai sus
ubos.beneficial_owners[].person.birth_datestring\|null	Data nașterii.	–	ca mai sus
ubos.beneficial_owners[].person.locationobject\|null	Domiciliul în home: city, county, state și country.Gol când nu se cunoaște niciun domiciliu	–	ca mai sus
ubos.beneficial_owners[].ownership_percentagenumber	Cota totală a persoanei în procente, adunată pe toate drumurile.	`50`	ca mai sus
ubos.beneficial_owners[].pathsarray	Fiecare drum până la persoană, cu cota de-a lungul acelui drum.	–	ca mai sus
ubos.beneficial_owners[].paths[].percentagenumber	Cota în procente care ajunge prin acest drum.	`50`	ca mai sus
ubos.beneficial_owners[].paths[].viaarray	Companiile de pe acest drum, întâi asociatul direct al companiei cerute (depth 1). Câmpurile sunt aceleași ca în via al cotelor nerezolvate.Gol când persoana deține părțile direct	–	ca mai sus

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
ubos.unresolved_beneficial_ownersarray	Cote care nu au putut fi urmărite până la o persoană.Gol când toate cotele sunt rezolvate`ubos` · Beta	–	de obicei: GmbH, UG rar: AG, SE, KGaA, GmbH & Co. KG, KG, OHG niciodată: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	De ce se termină lanțul aici. Se pot adăuga valori noi.Valori: `unlinked` asociatul este o companie pe care nu o putem potrivi cu o înscriere din registrul german, de obicei o companie din străinătate. Nu îi cunoaștem asociații, deci lanțul se termină aici, `no_further_shareholder_data` asociatul este o companie germană pe care o cunoaștem, dar pentru ea nu există o listă a asociaților, de exemplu un KG, `cycle` lanțul duce înapoi la o companie care apare deja în el, de exemplu când o companie își deține propriile părți, `unknown` nu se știe nimic despre asociat, nici numele, nici cota	`"cycle"`	ca mai sus
ubos.unresolved_beneficial_owners[].namestring\|null	Numele asociatului la care se termină lanțul.Gol când motivul este unknown	`"ENSoXX Holding AG"`	ca mai sus
ubos.unresolved_beneficial_owners[].entity_idstring\|null	ID-ul său, pentru propriul profil de companie.Gol când asociatul nu este potrivit cu o companie din datele noastre, adică la motivele unlinked și unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	ca mai sus
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Forma sa juridică.	`"AG"`	ca mai sus
ubos.unresolved_beneficial_owners[].addressobject\|array	Adresa sa cu street, house_number, postal_code, city, county, state, country și coordinates.Gol când nu se cunoaște nicio adresă; valoarea este atunci o listă goală []	–	ca mai sus
ubos.unresolved_beneficial_owners[].registrationobject\|array	Înscrierea sa în registru cu court, register_type și register_number, și din registre străine.Gol când nu se cunoaște nicio înscriere; valoarea este atunci o listă goală []	–	ca mai sus
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Cota nerezolvată în procente, calculată până la compania cerută. Poate fi 0.	`0`	ca mai sus
ubos.unresolved_beneficial_owners[].viaarray	Companiile prin care trece lanțul până aici, întâi asociatul direct al companiei cerute.Gol când cota nerezolvată este deținută direct în compania cerută	–	ca mai sus
ubos.unresolved_beneficial_owners[].via[].depthinteger	Nivelul: 1 este un asociat direct al companiei cerute. Alături se află name și entity_id ale companiei.	`1`	ca mai sus
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Cota în procente la acest nivel.	`94.5`	ca mai sus
ubos.coverageobject	Cât din capital este urmărit până la persoane și cât rămâne deschis. Cele două valori nu dau întotdeauna 100 împreună.	–	ca mai sus
ubos.coverage.resolved_percentagenumber	Urmărit până la persoane, în procente.	`5.5`	ca mai sus
ubos.coverage.unresolved_percentagenumber	Neurmărit până la persoane, în procente.	`0`	ca mai sus

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 · Răspuns exemplu: Hetzner Online GmbH cu funcția ubos. În cererea noastră exemplu, o persoană se afla în beneficial_owners cu 5,5%. Lanțul prin ENSoXX GmbH, Ansbach HRB 6105, s-a încheiat în unresolved_beneficial_owners cu motivele cycle și unknown.

Calculăm datele din listele asociaților. Datele despre beneficiarii reali din Transparenzregister (registrul de transparență) nu mai sunt accesibile public de la sfârșitul anului 2022.

Participații

Funcția shareholdings arată cealaltă direcție: la ce companii deține compania cerută părți. Participațiile provin din listele asociaților acelor companii. Costă 5 credite când există participații.

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

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholdingsobject\|null	Companiile la care compania cerută deține părți.Gol când nu se cunoaște nicio participație`shareholdings` · Beta	–	de obicei: AG, SE, KGaA parțial: GmbH, UG rar: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Participațiile actuale, câte una per companie.	–	ca mai sus
shareholdings.holdings.current[].organizationobject	Compania la care sunt deținute părțile.	–	ca mai sus
shareholdings.holdings.current[].organization.entity_idstring	ID-ul companiei, pentru profilul ei de companie.	`"63529c3a793e9f002196b4fd344e1241"`	ca mai sus
shareholdings.holdings.current[].organization.namestring\|null	Denumirea companiei.	`"Hetzner Cloud GmbH"`	ca mai sus
shareholdings.holdings.current[].organization.legal_formstring\|null	Forma juridică a companiei.	`"GmbH"`	ca mai sus
shareholdings.holdings.current[].organization.statusstring\|null	Statusul companiei în registru, de exemplu ACTIVE.	`"ACTIVE"`	ca mai sus
shareholdings.holdings.current[].organization.addressobject\|array	Adresa companiei, structurată ca address din datele de bază.Gol când nu se cunoaște nicio adresă; valoarea este atunci o listă goală []	–	ca mai sus
shareholdings.holdings.current[].organization.registrationobject\|array	Înscrierea în registru a companiei cu court, register_type și register_number.Gol când nu se cunoaște nicio înscriere; valoarea este atunci o listă goală []	–	ca mai sus
shareholdings.holdings.current[].ownership.percentagenumber\|null	Cota în procente: 100 înseamnă 100 %.Gol când lista nu indică nicio cotă	`100`	ca mai sus
shareholdings.holdings.current[].ownership.contributionobject	Valoarea nominală a părților cu amount și currency.	–	ca mai sus
shareholdings.holdings.current[].as_ofstring	Data listei asociaților din care provine participația.	`"2017-09-19"`	ca mai sus
shareholdings.summary.total_currentinteger	Numărul participațiilor actuale.	`2`	ca mai sus

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 · Răspuns exemplu: Hetzner Online GmbH cu funcția shareholdings

Participațiile unei persoane se află în profilul de persoană, cu aceeași funcție.

Structuri de grup

Legăturile de grup le compui din mai multe date. shareholders și shareholdings arată participațiile cu un nivel în sus și în jos, ubos persoanele de la capătul lanțului.

Rețeaua companiei leagă companii și persoane pe două niveluri. Include și companiile afiliate.

Fuziunile, divizările și alte transformări se află la Fuziuni & achiziții.