Εταίροι και συμμετοχές – Τεκμηρίωση

Feature
Feature	Τι επιστρέφει	Πιστώσεις	Διαθέσιμο
shareholders	Εταίροι: οι τρέχοντες εταίροι με τα μερίδιά τους και παλαιότερες λίστες εταίρων	5	κάθε λογαριασμός · Beta
shareholders_deep	Εταίροι σε βάθος: κάτοχοι με αριθμούς μεριδίων, από πότε κατέχουν μερίδια και τι άλλαξε τελευταία	80	Max
ubos	Πραγματικοί δικαιούχοι (UBO): τα πρόσωπα πίσω από την εταιρεία, υπολογισμένα από τις λίστες εταίρων	10	κάθε λογαριασμός · Beta
shareholdings	Συμμετοχές: εταιρείες στις οποίες συμμετέχει η ίδια η εταιρεία	5	κάθε λογαριασμός · Beta

Εταίροι ανά νομική μορφή

Τι λέει το μητρώο για τους ιδιοκτήτες εξαρτάται από τη νομική μορφή. Ο πίνακας δείχνει τι λαμβάνεις συνήθως.

Νομική μορφή
Νομική μορφή	Εταίροι στην απάντηση
GmbH, UG	Όλοι οι εταίροι από τη λίστα εταίρων κατά την § 40 GmbHG, με ονομαστικό ποσό και ποσοστό στο Stammkapital (εταιρικό κεφάλαιο), καθώς και παλαιότερες λίστες.
AG, SE, KGaA	Μόνο σε μεμονωμένες περιπτώσεις, γιατί οι μέτοχοι μιας AG δεν εμφανίζονται σε κανένα δημόσιο μητρώο.
GmbH & Co. KG	Οι ετερόρρυθμοι εταίροι (Kommanditisten) από το μητρώο με το ποσό ευθύνης τους, εν μέρει και η GmbH ως ομόρρυθμος εταίρος.
KG, OHG	Οι εγγεγραμμένοι εταίροι: για μια KG οι ομόρρυθμοι (Komplementäre) και οι ετερόρρυθμοι εταίροι, για μια OHG οι εταίροι με προσωπική ευθύνη.
e.K.	Ο ιδιοκτήτης.
eG	Κανένας. Ο κατάλογος μελών ενός συνεταιρισμού δεν είναι δημόσιος.
PartG	Οι εγγεγραμμένοι εταίροι.

Οι λίστες εταίρων είναι συχνά σαρωμένα έγγραφα σε πολλές διατάξεις. Τις εξάγουμε αυτόματα. Χρησιμοποιούμε γι’ αυτό τη νεότερη τεχνολογία και επενδύουμε πολλά στην ποιότητα· μεμονωμένα σφάλματα παραμένουν πιθανά.

Εταίροι

Το feature shareholders επιστρέφει τους τρέχοντες εταίρους: για μια GmbH από τη νεότερη λίστα εταίρων, για προσωπικές εταιρείες και ατομικούς εμπόρους από το μητρώο. Κοστίζει 5 πιστώσεις, αλλά μόνο όταν κατονομάζει τρέχοντες εταίρους. Αν επιστρέφει μόνο παλαιότερες λίστες, δεν κοστίζει τίποτα.

Κάθε καταχώριση στο entries περιγράφει ένα πρόσωπο ή μια εταιρεία. Ένα πρόσωπο έχει first_name, last_name και birth_date, μια εταιρεία entity_name, country_code και registration_reference.

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

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholdersobject\|null	Οι εταίροι της εταιρείας: τρέχουσα κατάσταση στο entries, παλαιότερες καταστάσεις στο history.Κενό όταν δεν είναι γνωστοί εταίροι, για παράδειγμα για μια AG ή eG`shareholders` · Beta	–	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders.entriesarray	Οι τρέχοντες εταίροι, μία καταχώριση ανά πρόσωπο ή εταιρεία.	–	όπως παραπάνω
shareholders.entries[].shareholderobject	Ποιος κατέχει το μερίδιο: ένα πρόσωπο ή μια εταιρεία, με τα παρακάτω πεδία.	–	όπως παραπάνω
shareholders.entries[].shareholder.entity_idstring\|null	ID του προσώπου ή της εταιρείας, για το δικό του προφίλ προσώπου ή προφίλ εταιρείας.Κενό όταν ο εταίρος δεν μπόρεσε να αντιστοιχιστεί με βεβαιότητα	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	όπως παραπάνω
shareholders.entries[].shareholder.first_namestring	Μικρό όνομα ενός προσώπου, με όλα τα καταχωρισμένα μικρά ονόματα.	–	πάντα: e.K. συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders.entries[].shareholder.last_namestring	Επώνυμο ενός προσώπου.	–	όπως παραπάνω
shareholders.entries[].shareholder.birth_datestring\|null	Ημερομηνία γέννησης ενός προσώπου, στη μορφή YYYY-MM-DD.Κενό όταν το έγγραφο δεν δίνει ημερομηνία γέννησης	–	όπως παραπάνω
shareholders.entries[].shareholder.entity_namestring	Επωνυμία μιας εταιρείας που είναι εταίρος.	`"ENSoXX GmbH"`	συνήθως: GmbH, UG, GmbH & Co. KG σπάνια: AG, SE, KGaA, KG, OHG ποτέ: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	Χώρα μιας εταιρείας ως τριψήφιος κωδικός ISO (ISO 3166-1 alpha-3), για παράδειγμα DEU.	`"DEU"`	όπως παραπάνω
shareholders.entries[].shareholder.registration_referencestring\|null	Εγγραφή μητρώου μιας εταιρείας ως κείμενο, όπως εμφανίζεται στο έγγραφο.Κενό όταν το έγγραφο δεν δίνει εγγραφή μητρώου, συχνά για αλλοδαπές εταιρείες	`"AG Ansbach HRB 6105"`	όπως παραπάνω
shareholders.entries[].shareholder.addressstring\|null	Διεύθυνση, τόπος κατοικίας ή έδρα ως κείμενο, όπως εμφανίζεται στο έγγραφο.Κενό όταν το έγγραφο δεν δίνει διεύθυνση	`"Gunzenhausen"`	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders.entries[].contributionobject\|null	Το ποσό της συμμετοχής με amount και currency: για μια GmbH το ονομαστικό ποσό των μεριδίων, για ετερόρρυθμους εταίρους το καταχωρισμένο Haftsumme (ποσό ευθύνης).Κενό όταν δεν είναι καταχωρισμένο ποσό, για παράδειγμα για εταίρους με προσωπική ευθύνη ή τον ιδιοκτήτη μιας e.K	–	συνήθως: GmbH, UG, GmbH & Co. KG εν μέρει: KG, OHG σπάνια: AG, SE, KGaA ποτέ: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Μερίδιο στο κεφάλαιο ως δεκαδικός: 1 σημαίνει 100 %, 0.245 σημαίνει 24,5 %.Κενό όταν δεν μπορεί να προκύψει μερίδιο, για παράδειγμα για προσωπικές εταιρείες	`0.945`	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders.entries[].roleobject	Ο ρόλος: label ως σταθερός κωδικός, καθώς και de και en με μια μακριά και μια σύντομη ονομασία, για παράδειγμα Kommanditist και Kom.	–	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders.entries[].role.labelstring	Ο ρόλος ως σταθερός κωδικός. Μπορούν να προστεθούν νέες τιμές.Τιμές: `SHAREHOLDER` εταίρος σύμφωνα με τη λίστα εταίρων, `LIMITED_PARTNER` ετερόρρυθμος εταίρος (Kommanditist), `FULLY_LIABLE_PARTNER` εταίρος με προσωπική ευθύνη (persönlich haftender Gesellschafter), `PARTNER` εταίρος μιας PartG, `OWNER` ιδιοκτήτης μιας e.K.	`"SHAREHOLDER"`	όπως παραπάνω
shareholders.total_capitalobject\|null	Το κεφάλαιο σύμφωνα με τη λίστα εταίρων, με amount και currency, η βάση για το contribution_ratio.Κενό όταν η λίστα δεν δίνει κεφάλαιο, καθώς και για προσωπικές εταιρείες	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG

Με το entity_id ενός εταίρου ανακτάς το δικό του προφίλ εταιρείας ή προφίλ προσώπου. Έτσι ακολουθείς μια αλυσίδα ιδιοκτησίας επίπεδο προς επίπεδο.

Ιστορικό εταίρων

Το shareholders.history περιλαμβάνεται χωρίς επιπλέον κόστος. Περιέχει την ημερομηνία της τρέχουσας λίστας και τις παλαιότερες λίστες εταίρων, τις νεότερες πρώτες.

Για μια KG ή GmbH & Co. KG, οι πρώην εταίροι βρίσκονται στο register_ownership, με ημερομηνίες εισόδου και αποχώρησης από το μητρώο. Για OHG, PartG και e.K. τους βρίσκεις στο shareholders_deep.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholders.historyobject	Παλαιότερες καταστάσεις των εταίρων, χωρίς επιπλέον κόστος.Κενό όταν δεν υπάρχουν παλαιότερες καταστάσεις· το πεδίο λείπει τότε, για παράδειγμα για OHG, PartG ή e.K`shareholders` · Beta	–	συνήθως: GmbH, UG εν μέρει: GmbH & Co. KG, KG, OHG σπάνια: AG, SE, KGaA ποτέ: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Ημερομηνία της λίστας εταίρων από την οποία προέρχεται το entries.Κενό όταν οι εταίροι προέρχονται από το μητρώο	`"2015-08-21"`	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders.history.pastarray	Παλαιότερες λίστες εταίρων, οι νεότερες πρώτες.Κενό όταν υπάρχει μόνο μία λίστα	–	όπως παραπάνω
shareholders.history.past[].as_ofstring	Ημερομηνία αυτής της λίστας εταίρων.	`"2015-07-28"`	όπως παραπάνω
shareholders.history.past[].data.total_capitalobject\|null	Το κεφάλαιο σύμφωνα με αυτή τη λίστα, με amount και currency. Παλαιότερες λίστες το δίνουν εν μέρει σε DEM.	–	όπως παραπάνω
shareholders.history.past[].data.shareholdersarray	Οι εταίροι σύμφωνα με αυτή τη λίστα, με τα ίδια πεδία όπως το entries.	–	όπως παραπάνω
shareholders.history.register_ownershipobject	Για KG και GmbH & Co. KG: πρώην εταίροι σύμφωνα με το μητρώο, στο past.	–	εν μέρει: GmbH & Co. KG, KG, OHG ποτέ: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	Ο πρώην εταίρος, με τα ίδια πεδία όπως στο entries.	–	όπως παραπάνω
shareholders.history.register_ownership.past[].roleobject	Ο ρόλος του, με την ίδια δομή όπως το role στο entries.	–	όπως παραπάνω
shareholders.history.register_ownership.past[].effective_fromstring\|null	Από πότε ήταν εγγεγραμμένος, στη μορφή YYYY-MM-DD.	`"2022-01-07"`	όπως παραπάνω
shareholders.history.register_ownership.past[].effective_tostring\|null	Έως πότε ήταν εγγεγραμμένος.	`"2026-07-06"`	όπως παραπάνω
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true αν το effective_to έχει συναχθεί και δεν είναι ρητά καταχωρισμένο.	`false`	όπως παραπάνω
shareholders.history.register_ownership.past[].contributionnull	Εδώ πάντα null.	–	όπως παραπάνω
shareholders.history.register_ownership.past[].contribution_rationull	Εδώ πάντα null.	–	όπως παραπάνω

Εταίροι σε βάθος

Το feature shareholders_deep περιλαμβάνεται στο πλάνο Max. Κοστίζει 80 πιστώσεις, αλλά μόνο όταν το τρέχον έγγραφο κατονομάζει τουλάχιστον έναν κάτοχο.

Διαβάζει όλες τις λίστες εταίρων μιας εταιρείας, όχι μόνο τη νεότερη. Έτσι δείχνει από πότε κάποιος κατέχει μερίδια, πώς ήταν οι παλαιότερες καταστάσεις και τι άλλαξε η τελευταία λίστα.

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

Το έγγραφο. Το record λέει από πού προέρχεται η τρέχουσα κατάσταση, το share_capital δίνει το κεφάλαιο σύμφωνα με αυτό το έγγραφο.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholders_deepobject\|null	Κάτοχοι, μερίδια, παλαιότερα έγγραφα και η τελευταία μεταβολή.Κενό όταν δεν είναι γνωστό τρέχον έγγραφο ούτε εγγεγραμμένος εταίρος, τυπικό για AG, SE και eG`shareholders_deep` · από Max	–	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.recordobject	Το έγγραφο από το οποίο προέρχεται η τρέχουσα κατάσταση: ημερομηνία και πηγή.	–	όπως παραπάνω
shareholders_deep.record.datestring\|null	Η ημερομηνία στην οποία αναφέρεται το έγγραφο. Συνήθως είναι λίγο μετά τη μεταβολή που δείχνει το έγγραφο.Κενό όταν οι εταίροι προέρχονται από το μητρώο (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.record.sourcestring	Το είδος του εγγράφου.Τιμές: `SHAREHOLDER_LIST` λίστα εταίρων (Gesellschafterliste), `FOUNDING_DOCUMENT` ιδρυτικό έγγραφο, δηλαδή Musterprotokoll (πρότυπο πρακτικό) ή Gesellschaftsvertrag (καταστατικό), `COMMERCIAL_REGISTER` εταίροι ή ιδιοκτήτες εγγεγραμμένοι στο μητρώο	`"SHAREHOLDER_LIST"`	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.share_capitalobject\|null	Το κεφάλαιο σύμφωνα με το έγγραφο: value, currency και basis.Κενό όταν το έγγραφο δεν δίνει κεφάλαιο, και πάντα για COMMERCIAL_REGISTER	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	Από πού προέρχεται το ποσό.Τιμές: `REPORTED` αναγράφεται στο έγγραφο, `CALCULATED` υπολογισμένο από τον αριθμό και το ονομαστικό ποσό των μεριδίων	`"REPORTED"`	όπως παραπάνω

Οι κάτοχοι. Κάθε καταχώριση στο entries είναι μία γραμμή του εγγράφου, το μεγαλύτερο μερίδιο πρώτο. Αν κάποιος έχει πολλές γραμμές, εμφανίζεται πολλές φορές στη λίστα.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholders_deep.entriesarray	Οι τρέχοντες κάτοχοι, μία γραμμή του εγγράφου ανά καταχώριση, το μεγαλύτερο μερίδιο πρώτο.`shareholders_deep` · από Max	–	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.entries[].holderobject	Ποιος κατέχει το μερίδιο. Το type καθορίζει ποια πεδία ακολουθούν.	–	όπως παραπάνω
shareholders_deep.entries[].holder.typestring	Το είδος του κατόχου.Τιμές: `ORGANIZATION` εταιρεία ή άλλος οργανισμός, `PERSON` φυσικό πρόσωπο, `JOINT` από κοινού κατεχόμενο μερίδιο, για παράδειγμα μιας κοινότητας κληρονόμων, με members	`"ORGANIZATION"`	όπως παραπάνω
shareholders_deep.entries[].holder.entity_idstring\|null	ID του κατόχου, για το δικό του προφίλ εταιρείας ή προφίλ προσώπου.Κενό όταν ο κάτοχος δεν μπόρεσε να αντιστοιχιστεί με βεβαιότητα, και πάντα για JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	όπως παραπάνω
shareholders_deep.entries[].holder.namestring	Το όνομα. Για κατόχους που έχουν αντιστοιχιστεί η τρέχουσα επωνυμία, διαφορετικά όπως στο έγγραφο.	`"ENSoXX GmbH"`	όπως παραπάνω
shareholders_deep.entries[].holder.birth_datestring\|null	Μόνο για πρόσωπα: η ημερομηνία γέννησης.Κενό όταν το έγγραφο δεν δίνει	–	πάντα: e.K. συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Μόνο για οργανισμούς: η νομική μορφή ως κείμενο, για παράδειγμα GmbH ή Ltd.	`"GmbH"`	συνήθως: GmbH, UG, GmbH & Co. KG σπάνια: AG, SE, KGaA, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Μόνο για οργανισμούς: η τρέχουσα κατάσταση στο μητρώο.Κενό όταν ο κάτοχος δεν έχει αντιστοιχιστεί, και πάντα στα παλαιότερα έγγραφα στο historyΤιμές: `ACTIVE` ενεργή, `INACTIVE` μη ενεργή πλέον, για παράδειγμα διαγραμμένη ή συγχωνευμένη	`"ACTIVE"`	όπως παραπάνω
shareholders_deep.entries[].holder.citystring\|null	Έδρα ή τόπος κατοικίας.	`"Gunzenhausen"`	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.entries[].holder.countrystring\|null	Χώρα ως τριψήφιος κωδικός ISO (ISO 3166-1 alpha-3), για παράδειγμα DEU, AUT ή LUX.	`"DEU"`	όπως παραπάνω
shareholders_deep.entries[].holder.registrationobject\|null	Μόνο για οργανισμούς: court, register_type και register_number.Κενό όταν δεν μπορεί να διαβαστεί εγγραφή μητρώου, για παράδειγμα για πολλές αλλοδαπές εταιρείες	–	συνήθως: GmbH, UG, GmbH & Co. KG σπάνια: AG, SE, KGaA, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Μόνο για οργανισμούς: η εγγραφή μητρώου ως κείμενο, όταν το registration λείπει ή δεν αναφέρει δικαστήριο.	`null`	σπάνια
shareholders_deep.entries[].rolestring	Ο ρόλος του κατόχου. Μπορούν να προστεθούν νέες τιμές.Τιμές: `SHAREHOLDER` εταίρος σύμφωνα με τη λίστα εταίρων ή το ιδρυτικό έγγραφο, `LIMITED_PARTNER` ετερόρρυθμος εταίρος (Kommanditist), `FULLY_LIABLE_PARTNER` εταίρος με προσωπική ευθύνη (persönlich haftender Gesellschafter), `PARTNER` εταίρος μιας PartG, `OWNER` ιδιοκτήτης μιας e.K.	`"SHAREHOLDER"`	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.entries[].sincestring\|null	Από πότε ο κάτοχος κατέχει μερίδια. Για εγγεγραμμένους εταίρους, η ημερομηνία εγγραφής.Κενό όταν δεν μπορεί να προσδιοριστεί ημερομηνία, και πάντα για JOINT	`"2015-08-18"`	όπως παραπάνω
shareholders_deep.entries[].since_basisstring\|null	Πόσο βέβαιο είναι το since.Τιμές: `ENTRY_RECORDED` τεκμηριωμένο από αυτή την ημερομηνία: η προηγούμενη λίστα δεν κατονομάζει ακόμη τον κάτοχο, `EARLIEST_RECORD` ήδη στο παλαιότερο διαθέσιμο έγγραφο, άρα εταίρος τουλάχιστον από αυτή την ημερομηνία	`"ENTRY_RECORDED"`	όπως παραπάνω

Το μερίδιο. Το ownership περιγράφει πόσα κατέχει ένας κάτοχος: σε ποσοστό, ως ονομαστικό ποσό και με τους αύξοντες αριθμούς των μεριδίων.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholders_deep.entries[].ownershipobject	Το μερίδιο του κατόχου.`shareholders_deep` · από Max	–	συνήθως: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG σπάνια: AG, SE, KGaA ποτέ: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Μερίδιο στο κεφάλαιο σε ποσοστό, από 0 έως 100. Είναι η άμεση συμμετοχή, όχι τα δικαιώματα ψήφου.Κενό όταν το μερίδιο δεν μπορεί να προσδιοριστεί αξιόπιστα, και πάντα για εγγεγραμμένους εταίρους προσωπικών εταιρειών	`94.5`	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	Από πού προέρχεται το percentage.Τιμές: `REPORTED` αναγράφεται στο έγγραφο ή προκύπτει από το ονομαστικό ποσό και το κεφάλαιο στο έγγραφο, `CALCULATED` υπολογισμένο από τον αριθμό και το ονομαστικό ποσό των μεριδίων	`"REPORTED"`	όπως παραπάνω
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Άθροισμα των ονομαστικών ποσών με value και currency. Για ετερόρρυθμους εταίρους το καταχωρισμένο Haftsumme (ποσό ευθύνης).Κενό όταν δεν είναι γνωστό ποσό	–	συνήθως: GmbH, UG, GmbH & Co. KG εν μέρει: KG, OHG σπάνια: AG, SE, KGaA ποτέ: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Αριθμός μεριδίων (Geschäftsanteile).Κενό όταν ο αριθμός δεν είναι γνωστός για όλα τα μερίδια	`47250`	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	Τα μερίδια με τους αύξοντες αριθμούς τους στη λίστα, ένα εύρος ανά σειρά ίσων μεριδίων.	–	όπως παραπάνω
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Πρώτος αύξων αριθμός του εύρους.	`1`	όπως παραπάνω
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Τελευταίος αύξων αριθμός του εύρους.	`47250`	όπως παραπάνω
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Αριθμός μεριδίων στο εύρος.	`47250`	όπως παραπάνω
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Ονομαστικό ποσό ανά μερίδιο στο εύρος, με value και currency.	–	όπως παραπάνω

Ιστορικό και μεταβολές. Το history περιέχει τα παλαιότερα έγγραφα με τα ίδια πεδία. Οι κάτοχοι εμφανίζονται εκεί όπως ήταν στο έγγραφο της εποχής. Το changes συγκρίνει την τρέχουσα κατάσταση με την προηγούμενη.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholders_deep.historyarray	Τα παλαιότερα έγγραφα, τα νεότερα πρώτα, το καθένα με record, share_capital και entries. Οι πρώην εγγεγραμμένοι εταίροι συγκεντρώνονται στην τελευταία καταχώριση.`shareholders_deep` · από Max	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	Για JOINT: οι συνδικαιούχοι τύπου PERSON ή ORGANIZATION, με τα ίδια πεδία όπως το holder.	–	σπάνια
shareholders_deep.history[].entries[].untilstring\|null	Μόνο στο στοιχείο του history με COMMERCIAL_REGISTER: πότε αποχώρησε ο εταίρος.	–	εν μέρει: GmbH & Co. KG, KG, OHG, PartG σπάνια: e.K. ποτέ: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	Τι άλλαξε με το τρέχον έγγραφο σε σύγκριση με το προηγούμενο.Κενό όταν δεν υπάρχει παλαιότερο έγγραφο, καθώς και όταν η τρέχουσα κατάσταση προέρχεται από το μητρώο ή από ιδρυτικό έγγραφο	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Ημερομηνία του προηγούμενου εγγράφου.	`"2015-07-16"`	όπως παραπάνω
shareholders_deep.changes.joinedarray	Νέοι κάτοχοι: holder με entity_id, type και name, καθώς και percentage.	–	όπως παραπάνω
shareholders_deep.changes.leftarray	Κάτοχοι που αποχώρησαν, με το μερίδιο που είχαν τελευταία.	–	όπως παραπάνω
shareholders_deep.changes.changedarray	Κάτοχοι των οποίων το μερίδιο άλλαξε.	–	όπως παραπάνω
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Μερίδιο σε ποσοστό στο προηγούμενο έγγραφο.	`100`	όπως παραπάνω
shareholders_deep.changes.changed[].percentage_afternumber\|null	Μερίδιο σε ποσοστό στο τρέχον έγγραφο.	`5.5`	όπως παραπάνω

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 · Παράδειγμα απάντησης: Hetzner Online GmbH με το feature shareholders_deep

Σε σύγκριση με το shareholders, το shareholders_deep προσθέτει τους αριθμούς μεριδίων, την ημερομηνία από την οποία κάποιος κατέχει μερίδια, τις μεταβολές και τα από κοινού κατεχόμενα μερίδια με τα μέλη τους. Για συγκρίσεις μεταξύ εταιρειών και ετών, χρησιμοποίησε καλύτερα παντού το ίδιο feature.

Πραγματικοί δικαιούχοι

Πραγματικοί δικαιούχοι είναι τα φυσικά πρόσωπα στα οποία ανήκει τελικά μια εταιρεία. Το feature ubos ακολουθεί τις λίστες εταίρων μέσα από τα επίπεδα ιδιοκτησίας μέχρι τα πρόσωπα. Η λίστα κατονομάζει κάθε πρόσωπο με υπολογισμένο μερίδιο, χωρίς ελάχιστο όριο. Κοστίζει 10 πιστώσεις όταν επιστρέφει δεδομένα.

Αν ένα μερίδιο δεν μπορεί να αναχθεί σε πρόσωπο, βρίσκεται στο unresolved_beneficial_owners με την αιτία. Συχνά το κατέχει μια εταιρεία του εξωτερικού. Τα δεδομένα μας καλύπτουν γερμανικές εταιρείες, οπότε δεν γνωρίζουμε τους εταίρους μιας εταιρείας του εξωτερικού. Το coverage δείχνει ποιο ποσοστό του κεφαλαίου ανάγεται σε πρόσωπα και πόσο μένει ανοιχτό. Οι δύο τιμές δεν αθροίζονται πάντα σε 100. Για το υπόλοιπο, τα δεδομένα εταίρων δεν κατονομάζουν κάτοχο.

Το feature χρεώνεται μόλις επιστρέψει αποτέλεσμα. Αυτό ισχύει και όταν όλα τα μερίδια βρίσκονται στο unresolved_beneficial_owners.

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

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
ubosobject\|null	Οι πραγματικοί δικαιούχοι, υπολογισμένοι από τις λίστες εταίρων μέσα από τα επίπεδα ιδιοκτησίας.Κενό όταν δεν μπορεί να σχηματιστεί αλυσίδα από λίστες εταίρων, για παράδειγμα για AG, eG ή e.K`ubos` · Beta	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
ubos.beneficial_ownersarray	Τα πρόσωπα στα οποία ανήκει η εταιρεία άμεσα ή μέσω άλλων εταιρειών.Κενό όταν κανένα μερίδιο δεν μπορεί να αναχθεί σε πρόσωπο	–	όπως παραπάνω
ubos.beneficial_owners[].personobject	Το πρόσωπο, με τα παρακάτω πεδία.	–	εν μέρει: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID του προσώπου, για το προφίλ προσώπου.Κενό όταν το πρόσωπο δεν μπόρεσε να αντιστοιχιστεί με βεβαιότητα	–	όπως παραπάνω
ubos.beneficial_owners[].person.namestring	Πλήρες όνομα.	–	όπως παραπάνω
ubos.beneficial_owners[].person.name_partsobject	Το όνομα σε μέρη: given και family, και canonical_name όταν είναι γνωστό.	–	όπως παραπάνω
ubos.beneficial_owners[].person.birth_datestring\|null	Ημερομηνία γέννησης.	–	όπως παραπάνω
ubos.beneficial_owners[].person.locationobject\|null	Τόπος κατοικίας στο home: city, county, state και country.Κενό όταν δεν είναι γνωστός τόπος κατοικίας	–	όπως παραπάνω
ubos.beneficial_owners[].ownership_percentagenumber	Συνολικό μερίδιο του προσώπου σε ποσοστό, αθροισμένο σε όλες τις διαδρομές.	`50`	όπως παραπάνω
ubos.beneficial_owners[].pathsarray	Κάθε διαδρομή προς το πρόσωπο, με το μερίδιο κατά μήκος αυτής της διαδρομής.	–	όπως παραπάνω
ubos.beneficial_owners[].paths[].percentagenumber	Μερίδιο σε ποσοστό που φτάνει μέσω αυτής της διαδρομής.	`50`	όπως παραπάνω
ubos.beneficial_owners[].paths[].viaarray	Οι εταιρείες σε αυτή τη διαδρομή, πρώτα ο άμεσος εταίρος της εταιρείας που ζητήθηκε (depth 1). Τα πεδία είναι τα ίδια όπως στο via των μη επιλυμένων μεριδίων.Κενό όταν το πρόσωπο κατέχει μερίδια άμεσα	–	όπως παραπάνω

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
ubos.unresolved_beneficial_ownersarray	Μερίδια που δεν μπόρεσαν να αναχθούν σε πρόσωπο.Κενό όταν όλα τα μερίδια έχουν επιλυθεί`ubos` · Beta	–	συνήθως: GmbH, UG σπάνια: AG, SE, KGaA, GmbH & Co. KG, KG, OHG ποτέ: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Γιατί η αλυσίδα τελειώνει εδώ. Μπορούν να προστεθούν νέες τιμές.Τιμές: `unlinked` ο εταίρος είναι εταιρεία που δεν μπορούμε να αντιστοιχίσουμε σε εγγραφή του γερμανικού μητρώου, συνήθως εταιρεία του εξωτερικού. Δεν γνωρίζουμε τους εταίρους της, οπότε η αλυσίδα τελειώνει εδώ, `no_further_shareholder_data` ο εταίρος είναι γερμανική εταιρεία που γνωρίζουμε, αλλά δεν υπάρχει λίστα εταίρων γι’ αυτήν, για παράδειγμα μια KG, `cycle` η αλυσίδα οδηγεί πίσω σε μια εταιρεία που υπάρχει ήδη σε αυτήν, για παράδειγμα όταν μια εταιρεία κατέχει δικά της μερίδια, `unknown` δεν είναι γνωστό τίποτα για τον εταίρο, ούτε όνομα ούτε μερίδιο	`"cycle"`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].namestring\|null	Όνομα του εταίρου όπου τελειώνει η αλυσίδα.Κενό όταν η αιτία είναι unknown	`"ENSoXX Holding AG"`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].entity_idstring\|null	Το ID του, για το δικό του προφίλ εταιρείας.Κενό όταν ο εταίρος δεν έχει αντιστοιχιστεί σε εταιρεία των δεδομένων μας, δηλαδή για τις αιτίες unlinked και unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].legal_formstring\|null	Η νομική του μορφή.	`"AG"`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].addressobject\|array	Η διεύθυνσή του με street, house_number, postal_code, city, county, state, country και coordinates.Κενό όταν δεν είναι γνωστή διεύθυνση· η τιμή είναι τότε μια κενή λίστα []	–	όπως παραπάνω
ubos.unresolved_beneficial_owners[].registrationobject\|array	Η εγγραφή μητρώου του με court, register_type και register_number, και από αλλοδαπά μητρώα.Κενό όταν δεν είναι γνωστή εγγραφή· η τιμή είναι τότε μια κενή λίστα []	–	όπως παραπάνω
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	Το μη επιλυμένο μερίδιο σε ποσοστό, υπολογισμένο έως την εταιρεία που ζητήθηκε. Μπορεί να είναι 0.	`0`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].viaarray	Οι εταιρείες μέσω των οποίων περνά η αλυσίδα έως εδώ, πρώτα ο άμεσος εταίρος της εταιρείας που ζητήθηκε.Κενό όταν το μη επιλυμένο μερίδιο κατέχεται άμεσα στην εταιρεία που ζητήθηκε	–	όπως παραπάνω
ubos.unresolved_beneficial_owners[].via[].depthinteger	Το επίπεδο: 1 είναι άμεσος εταίρος της εταιρείας που ζητήθηκε. Δίπλα βρίσκονται η επωνυμία και το entity_id της εταιρείας.	`1`	όπως παραπάνω
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Μερίδιο σε ποσοστό σε αυτό το επίπεδο.	`94.5`	όπως παραπάνω
ubos.coverageobject	Πόσο από το κεφάλαιο ανάγεται σε πρόσωπα και πόσο μένει ανοιχτό. Οι δύο τιμές δεν αθροίζονται πάντα σε 100.	–	όπως παραπάνω
ubos.coverage.resolved_percentagenumber	Ανάγεται σε πρόσωπα, σε ποσοστό.	`5.5`	όπως παραπάνω
ubos.coverage.unresolved_percentagenumber	Δεν ανάγεται σε πρόσωπα, σε ποσοστό.	`0`	όπως παραπάνω

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 · Παράδειγμα απάντησης: Hetzner Online GmbH με το feature ubos. Στο παράδειγμα αιτήματός μας, ένα πρόσωπο βρισκόταν στο beneficial_owners με 5,5%. Η αλυσίδα μέσω της ENSoXX GmbH, Ansbach HRB 6105, κατέληξε στο unresolved_beneficial_owners με τις αιτίες cycle και unknown.

Υπολογίζουμε τα δεδομένα από τις λίστες εταίρων. Τα δεδομένα για πραγματικούς δικαιούχους από το Transparenzregister (μητρώο διαφάνειας) δεν είναι δημόσια προσβάσιμα από τα τέλη του 2022.

Συμμετοχές

Το feature shareholdings δείχνει την άλλη κατεύθυνση: σε ποιες εταιρείες συμμετέχει η εταιρεία που ζητήθηκε. Οι συμμετοχές προέρχονται από τις λίστες εταίρων αυτών των εταιρειών. Κοστίζει 5 πιστώσεις όταν υπάρχουν συμμετοχές.

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

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholdingsobject\|null	Οι εταιρείες στις οποίες συμμετέχει η εταιρεία που ζητήθηκε.Κενό όταν δεν είναι γνωστή καμία συμμετοχή`shareholdings` · Beta	–	συνήθως: AG, SE, KGaA εν μέρει: GmbH, UG σπάνια: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	Οι τρέχουσες συμμετοχές, μία ανά εταιρεία.	–	όπως παραπάνω
shareholdings.holdings.current[].organizationobject	Η εταιρεία στην οποία υπάρχει η συμμετοχή.	–	όπως παραπάνω
shareholdings.holdings.current[].organization.entity_idstring	ID της εταιρείας, για το προφίλ εταιρείας της.	`"63529c3a793e9f002196b4fd344e1241"`	όπως παραπάνω
shareholdings.holdings.current[].organization.namestring\|null	Επωνυμία της εταιρείας.	`"Hetzner Cloud GmbH"`	όπως παραπάνω
shareholdings.holdings.current[].organization.legal_formstring\|null	Νομική μορφή της εταιρείας.	`"GmbH"`	όπως παραπάνω
shareholdings.holdings.current[].organization.statusstring\|null	Κατάσταση της εταιρείας στο μητρώο, για παράδειγμα ACTIVE.	`"ACTIVE"`	όπως παραπάνω
shareholdings.holdings.current[].organization.addressobject\|array	Διεύθυνση της εταιρείας, με την ίδια δομή όπως το address στα βασικά στοιχεία.Κενό όταν δεν είναι γνωστή διεύθυνση· η τιμή είναι τότε μια κενή λίστα []	–	όπως παραπάνω
shareholdings.holdings.current[].organization.registrationobject\|array	Εγγραφή μητρώου της εταιρείας με court, register_type και register_number.Κενό όταν δεν είναι γνωστή εγγραφή· η τιμή είναι τότε μια κενή λίστα []	–	όπως παραπάνω
shareholdings.holdings.current[].ownership.percentagenumber\|null	Μερίδιο σε ποσοστό: 100 σημαίνει 100 %.Κενό όταν η λίστα δεν δίνει μερίδιο	`100`	όπως παραπάνω
shareholdings.holdings.current[].ownership.contributionobject	Ονομαστικό ποσό των μεριδίων με amount και currency.	–	όπως παραπάνω
shareholdings.holdings.current[].as_ofstring	Ημερομηνία της λίστας εταίρων από την οποία προέρχεται η συμμετοχή.	`"2017-09-19"`	όπως παραπάνω
shareholdings.summary.total_currentinteger	Πλήθος τρεχουσών συμμετοχών.	`2`	όπως παραπάνω

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 · Παράδειγμα απάντησης: Hetzner Online GmbH με το feature shareholdings

Οι συμμετοχές ενός προσώπου βρίσκονται στο προφίλ προσώπου, με το ίδιο feature.

Ομιλικές δομές

Τις ομιλικές συνδέσεις τις συνθέτεις από πολλά σημεία δεδομένων. Τα shareholders και shareholdings δείχνουν τις συμμετοχές ένα επίπεδο πάνω και κάτω, το ubos τα πρόσωπα στο τέλος της αλυσίδας.

Το Δίκτυο εταιρείας συνδέει εταιρείες και πρόσωπα σε δύο επίπεδα. Περιλαμβάνει και συνδεδεμένες εταιρείες.

Οι συγχωνεύσεις, οι διασπάσεις και άλλοι μετασχηματισμοί βρίσκονται στις Συγχωνεύσεις & εξαγορές.