Soci e partecipazioni – Documentazione

Feature
Feature	Cosa restituisce	Crediti	Disponibile
shareholders	Soci: i soci attuali con le loro quote e gli elenchi soci precedenti	5	ogni account · Beta
shareholders_deep	Soci approfonditi: titolari con numeri delle quote, da quando detengono quote e cosa è cambiato per ultimo	80	Max
ubos	Titolari effettivi (UBO): le persone dietro l’azienda, calcolate dagli elenchi soci	10	ogni account · Beta
shareholdings	Partecipazioni: aziende in cui l’azienda stessa detiene quote	5	ogni account · Beta

Soci per forma giuridica

Cosa dice il registro sui proprietari dipende dalla forma giuridica. La tabella mostra cosa ricevi tipicamente.

Forma giuridica
Forma giuridica	Soci nella risposta
GmbH, UG	Tutti i soci dall’elenco soci ai sensi del § 40 GmbHG, con valore nominale e quota del capitale sociale (Stammkapital), più gli elenchi precedenti.
AG, SE, KGaA	Solo in casi singoli, perché gli azionisti di una AG non sono in alcun registro pubblico.
GmbH & Co. KG	Gli accomandanti (Kommanditisten) dal registro con il loro importo di responsabilità, in parte anche la GmbH socia accomandataria.
KG, OHG	I soci iscritti: per una KG i soci accomandatari (Komplementäre) e gli accomandanti, per una OHG i soci a responsabilità illimitata.
e.K.	Il titolare.
eG	Nessuno. L’elenco dei membri di una cooperativa non è pubblico.
PartG	I soci iscritti.

Gli elenchi soci sono spesso documenti scansionati con molti layout diversi. Li estraiamo automaticamente. Usiamo la tecnologia più recente e investiamo molto nella qualità; singoli errori restano comunque possibili.

Soci

La feature shareholders restituisce i soci attuali: per una GmbH dall’elenco soci più recente, per società di persone e imprenditori individuali dal registro. Costa 5 crediti, ma solo se indica soci attuali. Se restituisce solo elenchi precedenti, non costa nulla.

Ogni voce in entries descrive una persona o un’azienda. Una persona ha first_name, last_name e birth_date, un’azienda entity_name, country_code e registration_reference.

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

Campo
Campo	Significato	Esempio	Disponibilità
shareholdersobject\|null	I soci dell’azienda: stato attuale in entries, stati precedenti in history.Vuoto se non sono noti soci, ad esempio per una AG o eG`shareholders` · Beta	–	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders.entriesarray	I soci attuali, una voce per persona o azienda.	–	come sopra
shareholders.entries[].shareholderobject	Chi detiene la quota: una persona o un’azienda, con i campi sotto.	–	come sopra
shareholders.entries[].shareholder.entity_idstring\|null	ID della persona o dell’azienda, per il suo profilo persona o profilo aziendale.Vuoto se il socio non è stato abbinato con certezza	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	come sopra
shareholders.entries[].shareholder.first_namestring	Nome di una persona, con tutti i nomi iscritti.	–	sempre: e.K. quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG raramente: AG, SE, KGaA mai: eG
shareholders.entries[].shareholder.last_namestring	Cognome di una persona.	–	come sopra
shareholders.entries[].shareholder.birth_datestring\|null	Data di nascita di una persona, nel formato YYYY-MM-DD.Vuoto se il documento non indica una data di nascita	–	come sopra
shareholders.entries[].shareholder.entity_namestring	Nome di un’azienda che è socia.	`"ENSoXX GmbH"`	quasi sempre: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG mai: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Paese di un’azienda come codice ISO a tre lettere (ISO 3166-1 alpha-3), ad esempio DEU.	`"DEU"`	come sopra
shareholders.entries[].shareholder.registration_referencestring\|null	Iscrizione nel registro di un’azienda come testo, come compare nel documento.Vuoto se il documento non indica un’iscrizione nel registro, spesso per aziende estere	`"AG Ansbach HRB 6105"`	come sopra
shareholders.entries[].shareholder.addressstring\|null	Indirizzo, luogo di residenza o sede come testo, come compare nel documento.Vuoto se il documento non indica un indirizzo	`"Gunzenhausen"`	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders.entries[].contributionobject\|null	L’importo della partecipazione con amount e currency: per una GmbH il valore nominale delle quote, per gli accomandanti l’importo di responsabilità iscritto (Haftsumme).Vuoto se non è iscritto alcun importo, ad esempio per soci a responsabilità illimitata o il titolare di una e.K	–	quasi sempre: GmbH, UG, GmbH & Co. KG in parte: KG, OHG raramente: AG, SE, KGaA mai: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Quota del capitale come decimale: 1 significa 100 %, 0.245 significa 24,5 %.Vuoto se non si può ricavare una quota, ad esempio per società di persone	`0.945`	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders.entries[].roleobject	Il ruolo: label come codice fisso, più de ed en con un nome lungo e uno breve, ad esempio Kommanditist e Kom.	–	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders.entries[].role.labelstring	Il ruolo come codice fisso. Possono aggiungersi nuovi valori.Valori: `SHAREHOLDER` socio secondo l’elenco soci, `LIMITED_PARTNER` accomandante (Kommanditist), `FULLY_LIABLE_PARTNER` socio a responsabilità illimitata (persönlich haftender Gesellschafter), `PARTNER` socio di una PartG, `OWNER` titolare di una e.K.	`"SHAREHOLDER"`	come sopra
shareholders.total_capitalobject\|null	Il capitale secondo l’elenco soci, con amount e currency, la base per contribution_ratio.Vuoto se l’elenco non indica un capitale, e per le società di persone	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG

Con l’entity_id di un socio recuperi il suo profilo aziendale o profilo persona. Così segui una catena proprietaria livello per livello.

Storico dei soci

shareholders.history arriva senza costi aggiuntivi. Contiene la data dell’elenco attuale e gli elenchi soci precedenti, il più recente per primo.

Per una KG o GmbH & Co. KG i soci passati sono in register_ownership, con date di ingresso e di uscita dal registro. Per OHG, PartG ed e.K. li trovi in shareholders_deep.

Campo
Campo	Significato	Esempio	Disponibilità
shareholders.historyobject	Stati precedenti dei soci, senza costi aggiuntivi.Vuoto se non esistono stati precedenti; il campo allora manca, ad esempio per OHG, PartG o e.K`shareholders` · Beta	–	quasi sempre: GmbH, UG in parte: GmbH & Co. KG, KG, OHG raramente: AG, SE, KGaA mai: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Data dell’elenco soci da cui proviene entries.Vuoto se i soci vengono dal registro	`"2015-08-21"`	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders.history.pastarray	Elenchi soci precedenti, il più recente per primo.Vuoto se esiste un solo elenco	–	come sopra
shareholders.history.past[].as_ofstring	Data di questo elenco soci.	`"2015-07-28"`	come sopra
shareholders.history.past[].data.total_capitalobject\|null	Il capitale secondo questo elenco, con amount e currency. Gli elenchi più vecchi lo indicano in parte in DEM.	–	come sopra
shareholders.history.past[].data.shareholdersarray	I soci secondo questo elenco, con gli stessi campi di entries.	–	come sopra
shareholders.history.register_ownershipobject	Per KG e GmbH & Co. KG: soci passati secondo il registro, in past.	–	in parte: GmbH & Co. KG, KG, OHG mai: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Il socio passato, con gli stessi campi di entries.	–	come sopra
shareholders.history.register_ownership.past[].roleobject	Il suo ruolo, strutturato come role in entries.	–	come sopra
shareholders.history.register_ownership.past[].effective_fromstring\|null	Da quando era iscritto, nel formato YYYY-MM-DD.	`"2022-01-07"`	come sopra
shareholders.history.register_ownership.past[].effective_tostring\|null	Fino a quando era iscritto.	`"2026-07-06"`	come sopra
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true se effective_to è ricavato e non iscritto esplicitamente.	`false`	come sopra
shareholders.history.register_ownership.past[].contributionnull	Qui sempre null.	–	come sopra
shareholders.history.register_ownership.past[].contribution_rationull	Qui sempre null.	–	come sopra

Soci approfonditi

La feature shareholders_deep è inclusa nel piano Max. Costa 80 crediti, ma solo se il documento attuale indica almeno un titolare.

Legge tutti gli elenchi soci di un’azienda, non solo il più recente. Così mostra da quando qualcuno detiene quote, come apparivano gli stati precedenti e cosa ha cambiato l’ultimo elenco.

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

Il documento. record dice da dove viene lo stato attuale, share_capital indica il capitale secondo quel documento.

Campo
Campo	Significato	Esempio	Disponibilità
shareholders_deepobject\|null	Titolari, quote, documenti precedenti e l’ultima modifica.Vuoto se non è noto alcun documento attuale né alcun socio iscritto, tipico per AG, SE ed eG`shareholders_deep` · da Max	–	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.recordobject	Il documento da cui viene lo stato attuale: data e fonte.	–	come sopra
shareholders_deep.record.datestring\|null	La data a cui si riferisce il documento. Di solito è poco dopo la modifica che il documento mostra.Vuoto se i soci vengono dal registro (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.record.sourcestring	Il tipo di documento.Valori: `SHAREHOLDER_LIST` elenco soci (Gesellschafterliste), `FOUNDING_DOCUMENT` atto costitutivo, cioè Musterprotokoll (protocollo standard) o Gesellschaftsvertrag (atto costitutivo), `COMMERCIAL_REGISTER` soci o titolari iscritti nel registro	`"SHAREHOLDER_LIST"`	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.share_capitalobject\|null	Il capitale secondo il documento: valore, valuta e base.Vuoto se il documento non indica un capitale, e sempre per COMMERCIAL_REGISTER	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Da dove viene l’importo.Valori: `REPORTED` indicato nel documento, `CALCULATED` calcolato da numero e valore nominale delle quote	`"REPORTED"`	come sopra

I titolari. Ogni voce in entries è una riga del documento, la quota più grande per prima. Se qualcuno ha più righe, compare più volte nella lista.

Campo
Campo	Significato	Esempio	Disponibilità
shareholders_deep.entriesarray	I titolari attuali, una riga del documento per voce, la quota più grande per prima.`shareholders_deep` · da Max	–	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.entries[].holderobject	Chi detiene la quota. type determina quali campi seguono.	–	come sopra
shareholders_deep.entries[].holder.typestring	Il tipo di titolare.Valori: `ORGANIZATION` azienda o altra organizzazione, `PERSON` persona fisica, `JOINT` quota detenuta in comune, ad esempio da una comunione ereditaria, con members	`"ORGANIZATION"`	come sopra
shareholders_deep.entries[].holder.entity_idstring\|null	ID del titolare, per il suo profilo aziendale o profilo persona.Vuoto se il titolare non è stato abbinato con certezza, e sempre per JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	come sopra
shareholders_deep.entries[].holder.namestring	Il nome. Per i titolari abbinati il nome attuale, altrimenti come nel documento.	`"ENSoXX GmbH"`	come sopra
shareholders_deep.entries[].holder.birth_datestring\|null	Solo per le persone: la data di nascita.Vuoto se il documento non la indica	–	sempre: e.K. quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Solo per le organizzazioni: la forma giuridica come testo, ad esempio GmbH o Ltd.	`"GmbH"`	quasi sempre: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG mai: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Solo per le organizzazioni: lo stato attuale nel registro.Vuoto se il titolare non è abbinato, e sempre nei documenti precedenti in historyValori: `ACTIVE` attiva, `INACTIVE` non più attiva, ad esempio cancellata o fusa	`"ACTIVE"`	come sopra
shareholders_deep.entries[].holder.citystring\|null	Sede o luogo di residenza.	`"Gunzenhausen"`	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.entries[].holder.countrystring\|null	Paese come codice ISO a tre lettere (ISO 3166-1 alpha-3), ad esempio DEU, AUT o LUX.	`"DEU"`	come sopra
shareholders_deep.entries[].holder.registrationobject\|null	Solo per le organizzazioni: court, register_type e register_number.Vuoto se non si può leggere alcuna iscrizione nel registro, ad esempio per molte aziende estere	–	quasi sempre: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG mai: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Solo per le organizzazioni: l’iscrizione nel registro come testo, quando registration manca o non indica un tribunale.	`null`	raramente
shareholders_deep.entries[].rolestring	Il ruolo del titolare. Possono aggiungersi nuovi valori.Valori: `SHAREHOLDER` socio secondo l’elenco soci o l’atto costitutivo, `LIMITED_PARTNER` accomandante (Kommanditist), `FULLY_LIABLE_PARTNER` socio a responsabilità illimitata (persönlich haftender Gesellschafter), `PARTNER` socio di una PartG, `OWNER` titolare di una e.K.	`"SHAREHOLDER"`	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.entries[].sincestring\|null	Da quando il titolare detiene quote. Per i soci iscritti, la data di iscrizione.Vuoto se non si può determinare una data, e sempre per JOINT	`"2015-08-18"`	come sopra
shareholders_deep.entries[].since_basisstring\|null	Quanto è certo since.Valori: `ENTRY_RECORDED` documentato da questa data: l’elenco precedente non indica ancora il titolare, `EARLIEST_RECORD` già nel documento più vecchio disponibile, quindi socio almeno da questa data	`"ENTRY_RECORDED"`	come sopra

La quota. ownership descrive quanto detiene un titolare: in percentuale, come valore nominale e tramite i numeri progressivi delle quote.

Campo
Campo	Significato	Esempio	Disponibilità
shareholders_deep.entries[].ownershipobject	La quota del titolare.`shareholders_deep` · da Max	–	quasi sempre: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA mai: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Quota del capitale in percentuale, da 0 a 100. È la partecipazione diretta, non i diritti di voto.Vuoto se la quota non si può determinare in modo affidabile, e sempre per i soci iscritti delle società di persone	`94.5`	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Da dove viene percentage.Valori: `REPORTED` indicato nel documento o ricavato da valore nominale e capitale nel documento, `CALCULATED` calcolato da numero e valore nominale delle quote	`"REPORTED"`	come sopra
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Somma dei valori nominali con value e currency. Per gli accomandanti l’importo di responsabilità iscritto (Haftsumme).Vuoto se non è noto alcun importo	–	quasi sempre: GmbH, UG, GmbH & Co. KG in parte: KG, OHG raramente: AG, SE, KGaA mai: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Numero di quote (Geschäftsanteile).Vuoto se il numero non è noto per tutte le quote	`47250`	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Le quote tramite i loro numeri progressivi nell’elenco, un intervallo per ogni serie di quote uguali.	–	come sopra
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Primo numero progressivo dell’intervallo.	`1`	come sopra
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Ultimo numero progressivo dell’intervallo.	`47250`	come sopra
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Numero di quote nell’intervallo.	`47250`	come sopra
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Valore nominale per quota nell’intervallo, con value e currency.	–	come sopra

Storico e modifiche. history contiene i documenti precedenti con gli stessi campi. I titolari vi compaiono come risultavano nel documento di allora. changes confronta lo stato attuale con quello precedente.

Campo
Campo	Significato	Esempio	Disponibilità
shareholders_deep.historyarray	I documenti precedenti, il più recente per primo, ciascuno con record, share_capital ed entries. I soci iscritti passati sono raccolti nell’ultima voce.`shareholders_deep` · da Max	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	Per JOINT: i contitolari di tipo PERSON o ORGANIZATION, con gli stessi campi di holder.	–	raramente
shareholders_deep.history[].entries[].untilstring\|null	Solo nella voce di history con COMMERCIAL_REGISTER: quando il socio è uscito.	–	in parte: GmbH & Co. KG, KG, OHG, PartG raramente: e.K. mai: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Cosa è cambiato con il documento attuale rispetto al precedente.Vuoto se non c’è un documento precedente, e quando lo stato attuale viene dal registro o da un atto costitutivo	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Data del documento precedente.	`"2015-07-16"`	come sopra
shareholders_deep.changes.joinedarray	Nuovi titolari: holder con entity_id, type e name, più percentage.	–	come sopra
shareholders_deep.changes.leftarray	Titolari usciti, con la quota che avevano per ultima.	–	come sopra
shareholders_deep.changes.changedarray	Titolari la cui quota è cambiata.	–	come sopra
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Quota in percentuale nel documento precedente.	`100`	come sopra
shareholders_deep.changes.changed[].percentage_afternumber\|null	Quota in percentuale nel documento attuale.	`5.5`	come sopra

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 · Risposta di esempio: Hetzner Online GmbH con la feature shareholders_deep

Rispetto a shareholders, shareholders_deep aggiunge i numeri delle quote, la data da cui qualcuno detiene quote, le modifiche e le quote detenute in comune con i loro membri. Per confronti tra aziende e anni è meglio usare sempre la stessa feature.

Titolari effettivi

I titolari effettivi sono le persone fisiche che in ultima istanza possiedono un’azienda. La feature ubos segue gli elenchi soci attraverso i livelli di proprietà fino alle persone. La lista indica ogni persona con una quota calcolata, senza soglia minima. Costa 10 crediti quando restituisce dati.

Se una quota non si può ricondurre a una persona, è in unresolved_beneficial_owners con il motivo. Spesso la detiene una società estera. I nostri dati coprono aziende tedesche, quindi non conosciamo i soci di una società estera. coverage mostra quale percentuale del capitale è ricondotta a persone e quanto resta aperto. I due valori non sempre sommano a 100. Per il resto, i dati sui soci non indicano alcun titolare.

La feature viene addebitata non appena restituisce un risultato. Vale anche quando tutte le quote sono in unresolved_beneficial_owners.

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

Campo
Campo	Significato	Esempio	Disponibilità
ubosobject\|null	I titolari effettivi, calcolati dagli elenchi soci attraverso i livelli di proprietà.Vuoto se dagli elenchi soci non si può costruire una catena, ad esempio per AG, eG o e.K`ubos` · Beta	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
ubos.beneficial_ownersarray	Le persone che possiedono l’azienda direttamente o tramite altre aziende.Vuoto se nessuna quota si può ricondurre a una persona	–	come sopra
ubos.beneficial_owners[].personobject	La persona, con i campi sotto.	–	in parte: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID della persona, per il profilo persona.Vuoto se la persona non è stata abbinata con certezza	–	come sopra
ubos.beneficial_owners[].person.namestring	Nome completo.	–	come sopra
ubos.beneficial_owners[].person.name_partsobject	Il nome nelle sue parti: given e family, e canonical_name se noto.	–	come sopra
ubos.beneficial_owners[].person.birth_datestring\|null	Data di nascita.	–	come sopra
ubos.beneficial_owners[].person.locationobject\|null	Luogo di residenza in home: city, county, state e country.Vuoto se non è noto alcun luogo di residenza	–	come sopra
ubos.beneficial_owners[].ownership_percentagenumber	Quota complessiva della persona in percentuale, sommata su tutti i percorsi.	`50`	come sopra
ubos.beneficial_owners[].pathsarray	Ogni percorso verso la persona, con la quota lungo quel percorso.	–	come sopra
ubos.beneficial_owners[].paths[].percentagenumber	Quota in percentuale che arriva tramite questo percorso.	`50`	come sopra
ubos.beneficial_owners[].paths[].viaarray	Le aziende su questo percorso, prima il socio diretto dell’azienda richiesta (depth 1). I campi sono gli stessi di via nelle quote non risolte.Vuoto se la persona detiene quote direttamente	–	come sopra

Campo
Campo	Significato	Esempio	Disponibilità
ubos.unresolved_beneficial_ownersarray	Quote che non si sono potute ricondurre a una persona.Vuoto se tutte le quote sono risolte`ubos` · Beta	–	quasi sempre: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG mai: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Perché la catena finisce qui. Possono aggiungersi nuovi valori.Valori: `unlinked` il socio è un’azienda che non riusciamo ad abbinare a un’iscrizione nel registro tedesco, di solito un’azienda estera. Non ne conosciamo i soci, quindi la catena finisce qui, `no_further_shareholder_data` il socio è un’azienda tedesca che conosciamo, ma per essa non esiste un elenco soci, ad esempio una KG, `cycle` la catena riporta a un’azienda che vi compare già, ad esempio quando un’azienda detiene quote proprie, `unknown` del socio non si sa nulla, né il nome né la quota	`"cycle"`	come sopra
ubos.unresolved_beneficial_owners[].namestring\|null	Nome del socio in cui finisce la catena.Vuoto se il motivo è unknown	`"ENSoXX Holding AG"`	come sopra
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Il suo ID, per il suo profilo aziendale.Vuoto se il socio non è abbinato a un’azienda nei nostri dati, cioè per i motivi unlinked e unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	come sopra
ubos.unresolved_beneficial_owners[].legal_formstring\|null	La sua forma giuridica.	`"AG"`	come sopra
ubos.unresolved_beneficial_owners[].addressobject\|array	Il suo indirizzo con street, house_number, postal_code, city, county, state, country e coordinates.Vuoto se non è noto alcun indirizzo; il valore è allora una lista vuota []	–	come sopra
ubos.unresolved_beneficial_owners[].registrationobject\|array	La sua iscrizione nel registro con court, register_type e register_number, anche da registri esteri.Vuoto se non è nota alcuna iscrizione; il valore è allora una lista vuota []	–	come sopra
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	La quota non risolta in percentuale, calcolata fino all’azienda richiesta. Può essere 0.	`0`	come sopra
ubos.unresolved_beneficial_owners[].viaarray	Le aziende attraverso cui passa la catena fin qui, prima il socio diretto dell’azienda richiesta.Vuoto se la quota non risolta è detenuta direttamente nell’azienda richiesta	–	come sopra
ubos.unresolved_beneficial_owners[].via[].depthinteger	Il livello: 1 è un socio diretto dell’azienda richiesta. Accanto ci sono name ed entity_id dell’azienda.	`1`	come sopra
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Quota in percentuale a questo livello.	`94.5`	come sopra
ubos.coverageobject	Quanto del capitale è ricondotto a persone e quanto resta aperto. I due valori non sempre sommano a 100.	–	come sopra
ubos.coverage.resolved_percentagenumber	Ricondotto a persone, in percentuale.	`5.5`	come sopra
ubos.coverage.unresolved_percentagenumber	Non ricondotto a persone, in percentuale.	`0`	come sopra

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 · Risposta di esempio: Hetzner Online GmbH con la feature ubos. Nella nostra richiesta di esempio una persona era in beneficial_owners con il 5,5%. La catena attraverso ENSoXX GmbH, Ansbach HRB 6105, terminava in unresolved_beneficial_owners con i motivi cycle e unknown.

Calcoliamo i dati dagli elenchi soci. I dati sui titolari effettivi del Transparenzregister (registro della trasparenza) non sono più accessibili pubblicamente dalla fine del 2022.

Partecipazioni

La feature shareholdings mostra la direzione opposta: in quali aziende l’azienda richiesta detiene quote. Le partecipazioni vengono dagli elenchi soci di quelle aziende. Costa 5 crediti quando ci sono partecipazioni.

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

Campo
Campo	Significato	Esempio	Disponibilità
shareholdingsobject\|null	Le aziende in cui l’azienda richiesta detiene quote.Vuoto se non è nota alcuna partecipazione`shareholdings` · Beta	–	quasi sempre: AG, SE, KGaA in parte: GmbH, UG raramente: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Le partecipazioni attuali, una per azienda.	–	come sopra
shareholdings.holdings.current[].organizationobject	L’azienda in cui sono detenute le quote.	–	come sopra
shareholdings.holdings.current[].organization.entity_idstring	ID dell’azienda, per il suo profilo aziendale.	`"63529c3a793e9f002196b4fd344e1241"`	come sopra
shareholdings.holdings.current[].organization.namestring\|null	Nome dell’azienda.	`"Hetzner Cloud GmbH"`	come sopra
shareholdings.holdings.current[].organization.legal_formstring\|null	Forma giuridica dell’azienda.	`"GmbH"`	come sopra
shareholdings.holdings.current[].organization.statusstring\|null	Stato dell’azienda nel registro, ad esempio ACTIVE.	`"ACTIVE"`	come sopra
shareholdings.holdings.current[].organization.addressobject\|array	Indirizzo dell’azienda, strutturato come address nei dati di base.Vuoto se non è noto alcun indirizzo; il valore è allora una lista vuota []	–	come sopra
shareholdings.holdings.current[].organization.registrationobject\|array	Iscrizione nel registro dell’azienda con court, register_type e register_number.Vuoto se non è nota alcuna iscrizione; il valore è allora una lista vuota []	–	come sopra
shareholdings.holdings.current[].ownership.percentagenumber\|null	Quota in percentuale: 100 significa 100 %.Vuoto se dall’elenco non risulta alcuna quota	`100`	come sopra
shareholdings.holdings.current[].ownership.contributionobject	Valore nominale delle quote con amount e currency.	–	come sopra
shareholdings.holdings.current[].as_ofstring	Data dell’elenco soci da cui proviene la partecipazione.	`"2017-09-19"`	come sopra
shareholdings.summary.total_currentinteger	Numero di partecipazioni attuali.	`2`	come sopra

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 · Risposta di esempio: Hetzner Online GmbH con la feature shareholdings

Le partecipazioni di una persona sono nel profilo persona, con la stessa feature.

Strutture di gruppo

I collegamenti di gruppo li ricostruisci da più dati. shareholders e shareholdings mostrano le partecipazioni un livello sopra e sotto, ubos le persone alla fine della catena.

La Rete aziendale collega aziende e persone su due livelli. Comprende anche le società collegate.

Fusioni, scissioni e altre trasformazioni sono in Fusioni e acquisizioni.