Πρόσωπα και εκπροσώπηση – Τεκμηρίωση

Ανάκτηση προσώπων

Ζήτησε το feature related_persons. Η απάντηση περιέχει τότε το κλειδί related_persons με δύο λίστες: current για όσους κατέχουν σήμερα τον ρόλο τους και past για όσους έχουν αποχωρήσει. Κάθε ρόλος είναι ξεχωριστή καταχώριση. Στο παράδειγμα αιτήματός μας για τη Hetzner Online GmbH, Ansbach HRB 6089, το current περιείχε τρεις διαχειριστές. Δύο από αυτούς εμφανίστηκαν ξανά στο past με την παλαιότερη Prokura τους. Όλα τα προσωπικά δεδομένα στα παραδείγματα απαντήσεων είναι δείγματα.

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=related_persons'

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": ["related_persons"],
    },
)
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", "related_persons");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "name": "Hetzner Online GmbH",3  "related_persons": {4    "current": [5      {6        "entity_id": "ea3a1670232611a992727ed067216d07",7        "label": "MANAGING_DIRECTOR",8        "role": {9          "en": {10            "long": "Managing Director",11            "short": "MD"12          },13          "de": {14            "long": "Geschäftsführer",15            "short": "GF"16          }17        },18        "name": "Paul Musterwald",19        "start_date": "2019-01-04",20        "end_date": null,21        "birth_date": "1989-07-18",22        "name_parts": {23          "given": "Paul",24          "family": "Musterwald",25          "maiden": null,26          "canonical_name": "Musterwald, Paul",27          "previous_names": null28        },29        "location": {30          "home": {31            "city": "Exempelingen i. Bay."32          }33        },34        "organization_representation_scheme": {35          "current": [36            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."37          ],38          "history": [39            {40              "value": [41                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."42              ],43              "effective_from": "2002-10-15",44              "effective_to": "2015-07-28"45            },46            {47              "value": [48                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."49              ],50              "effective_from": "2015-07-28",51              "effective_to": null52            }53          ]54        },55        "role_representation_scheme": {56          "current": [57            "einzelvertretungsberechtigt."58          ],59          "history": [60            {61              "value": [62                "einzelvertretungsberechtigt."63              ],64              "effective_from": "2019-01-04",65              "effective_to": null66            }67          ]68        }69      },70      {71        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72        "label": "MANAGING_DIRECTOR",73        "role": {74          "en": {75            "long": "Managing Director",76            "short": "MD"77          },78          "de": {79            "long": "Geschäftsführer",80            "short": "GF"81          }82        },83        "name": "Jan Musterhuber",84        "start_date": "2019-01-04",85        "end_date": null,86        "birth_date": "1955-11-06",87        "name_parts": {88          "given": "Jan",89          "family": "Musterhuber",90          "maiden": null,91          "canonical_name": "Musterhuber, Jan",92          "previous_names": null93        },94        "location": {95          "home": {96            "city": "Probeingen"97          }98        },99        "organization_representation_scheme": {100          "current": [101            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102          ],103          "history": [104            {105              "value": [106                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."107              ],108              "effective_from": "2002-10-15",109              "effective_to": "2015-07-28"110            },111            {112              "value": [113                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."114              ],115              "effective_from": "2015-07-28",116              "effective_to": null117            }118          ]119        },120        "role_representation_scheme": {121          "current": [122            "einzelvertretungsberechtigt."123          ],124          "history": [125            {126              "value": [127                "einzelvertretungsberechtigt."128              ],129              "effective_from": "2019-01-04",130              "effective_to": null131            }132          ]133        }134      },135      {136        "entity_id": "08ed5f967956831ca6588930fd2693ed",137        "label": "MANAGING_DIRECTOR",138        "role": {139          "en": {140            "long": "Managing Director",141            "short": "MD"142          },143          "de": {144            "long": "Geschäftsführer",145            "short": "GF"146          }147        },148        "name": "Max Felix Mustermann",149        "start_date": "2015-07-28",150        "end_date": null,151        "birth_date": "1976-01-15",152        "name_parts": {153          "given": "Max Felix",154          "family": "Mustermann",155          "maiden": null,156          "canonical_name": "Mustermann, Max Felix",157          "previous_names": null158        },159        "location": {160          "home": {161            "city": "Musterheim"162          }163        },164        "organization_representation_scheme": {165          "current": [166            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."167          ],168          "history": [169            {170              "value": [171                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."172              ],173              "effective_from": "2002-10-15",174              "effective_to": "2015-07-28"175            },176            {177              "value": [178                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."179              ],180              "effective_from": "2015-07-28",181              "effective_to": null182            }183          ]184        },185        "role_representation_scheme": {186          "current": [187            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188          ],189          "history": [190            {191              "value": [192                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193              ],194              "effective_from": "2015-07-28",195              "effective_to": null196            }197          ]198        }199      }200    ],201    "past": [202      {203        "entity_id": "ea3a1670232611a992727ed067216d07",204        "label": "PROCURA",205        "role": {206          "en": {207            "long": "Procura",208            "short": "Procura"209          },210          "de": {211            "long": "Prokura",212            "short": "Prokura"213          }214        },215        "name": "Paul Musterwald",216        "start_date": "2015-07-28",217        "end_date": "2019-01-04",218        "birth_date": "1989-07-18",219        "name_parts": {220          "given": "Paul",221          "family": "Musterwald",222          "maiden": null,223          "canonical_name": "Musterwald, Paul",224          "previous_names": null225        },226        "location": {227          "home": {228            "city": "Exempelingen i. Bay."229          }230        },231        "organization_representation_scheme": {232          "latest": [233            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."234          ],235          "history": [236            {237              "value": [238                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."239              ],240              "effective_from": "2002-10-15",241              "effective_to": "2015-07-28"242            },243            {244              "value": [245                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."246              ],247              "effective_from": "2015-07-28",248              "effective_to": null249            }250          ]251        },252        "role_representation_scheme": {253          "latest": [254            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255          ],256          "history": [257            {258              "value": [259                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260              ],261              "effective_from": "2015-07-28",262              "effective_to": "2019-01-04"263            }264          ]265        }266      },267      {268        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269        "label": "PROCURA",270        "role": {271          "en": {272            "long": "Procura",273            "short": "Procura"274          },275          "de": {276            "long": "Prokura",277            "short": "Prokura"278          }279        },280        "name": "Jan Musterhuber",281        "start_date": "2015-07-28",282        "end_date": "2019-01-04",283        "birth_date": "1955-11-06",284        "name_parts": {285          "given": "Jan",286          "family": "Musterhuber",287          "maiden": null,288          "canonical_name": "Musterhuber, Jan",289          "previous_names": null290        },291        "location": {292          "home": {293            "city": "Probeingen"294          }295        },296        "organization_representation_scheme": {297          "latest": [298            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."299          ],300          "history": [301            {302              "value": [303                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."304              ],305              "effective_from": "2002-10-15",306              "effective_to": "2015-07-28"307            },308            {309              "value": [310                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."311              ],312              "effective_from": "2015-07-28",313              "effective_to": null314            }315          ]316        },317        "role_representation_scheme": {318          "latest": [319            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320          ],321          "history": [322            {323              "value": [324                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325              ],326              "effective_from": "2015-07-28",327              "effective_to": "2019-01-04"328            }329          ]330        }331      },332      {333        "entity_id": "08ed5f967956831ca6588930fd2693ed",334        "label": "BOARD",335        "role": {336          "en": {337            "long": "Board Member",338            "short": "Board"339          },340          "de": {341            "long": "Vorstandsmitglied",342            "short": "Vorstand"343          }344        },345        "name": "Max Felix Mustermann",346        "start_date": "2002-10-15",347        "end_date": "2015-07-28",348        "birth_date": "1976-01-15",349        "name_parts": {350          "given": "Max Felix",351          "family": "Mustermann",352          "maiden": null,353          "canonical_name": "Mustermann, Max Felix",354          "previous_names": null355        },356        "location": {357          "home": {358            "city": "Musterheim"359          }360        },361        "organization_representation_scheme": {362          "latest": [363            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."364          ],365          "history": [366            {367              "value": [368                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."369              ],370              "effective_from": "2002-10-15",371              "effective_to": "2015-07-28"372            },373            {374              "value": [375                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."376              ],377              "effective_from": "2015-07-28",378              "effective_to": null379            }380          ]381        },382        "role_representation_scheme": {383          "latest": [384            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385          ],386          "history": [387            {388              "value": [389                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390              ],391              "effective_from": "2002-10-15",392              "effective_to": "2015-07-28"393            }394          ]395        }396      }397    ]398  }399}

200 · Παράδειγμα απάντησης: Hetzner Online GmbH με το feature related_persons, συντομευμένο σε επωνυμία και πρόσωπα

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
related_personsobject\|null	Όλα τα καταχωρισμένα πρόσωπα της εταιρείας, χωρισμένα σε current και past.`related_persons`	–	πάντα
related_persons.currentarray	Πρόσωπα που κατέχουν σήμερα τον ρόλο τους.	–	όπως παραπάνω
related_persons.pastarray	Πρόσωπα που έχουν αποχωρήσει, με τα ίδια πεδία όπως το current. Στους δύο κανόνες εκπροσώπησης, το latest αντικαθιστά το current: η τελευταία εκδοχή πριν από την αποχώρηση.Κενό όταν κανείς δεν έχει αποχωρήσει από την εγγραφή	–	συνήθως

Πεδία ενός προσώπου

Κάθε καταχώριση στο current και στο past έχει τα ίδια πεδία. Χωρίς Πραγματικό χρόνο, ένα πρόσωπο έχει το ίδιο entity_id σε όλα τα προφίλ εταιρειών και στο προφίλ προσώπου. Έτσι το αναγνωρίζεις σε διαφορετικές εταιρείες. Τα πρόσωπα από ένα ερώτημα Πραγματικού χρόνου έχουν δικά τους ID.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
related_persons.current[].entity_idstring\|null	ID του προσώπου. Χωρίς Πραγματικό χρόνο, είναι το ίδιο σε όλα τα προφίλ εταιρειών και ταυτίζεται με το entity_id στο προφίλ προσώπου.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	πάντα
related_persons.current[].labelstring	Ρόλος ως σταθερή τιμή. Είναι δυνατές και άλλες τιμές.Τιμές: `MANAGING_DIRECTOR` διαχειριστής (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` έκτακτος διαχειριστής (Notgeschäftsführer), `BOARD` μέλος του διοικητικού συμβουλίου (Vorstand), `BOARD_CHAIR` πρόεδρος του διοικητικού συμβουλίου, `DIRECTOR` εκτελεστικό μέλος, για παράδειγμα μιας SE, `PROCURA` κάτοχος Prokura (Prokurist), `LIQUIDATOR` εκκαθαριστής, `INSOLVENCY_ADMINISTRATOR` σύνδικος αφερεγγυότητας, `REPRESENTATIVE` μόνιμος εκπρόσωπος, `FULLY_LIABLE_PARTNER` ομόρρυθμος εταίρος (persönlich haftender Gesellschafter), `LIMITED_PARTNER` ετερόρρυθμος εταίρος (Kommanditist), `PARTNER` εταίρος, `OWNER` ιδιοκτήτης (Inhaber), `PROPRIETOR` ιδιοκτήτης (Inhaber), `TREASURER` ταμίας σωματείου, `SECRETARY` γραμματέας σωματείου, `YOUTH_WARDEN` υπεύθυνος νεολαίας σωματείου, `WATER_WARDEN` υπεύθυνος υδάτων σωματείου, `OTHER` άλλος ρόλος	`"MANAGING_DIRECTOR"`	όπως παραπάνω
related_persons.current[].roleobject	Ονομασία ρόλου για εμφάνιση, σε de και en, η καθεμία μακριά (long) και σύντομη (short), για παράδειγμα Geschäftsführer και GF.	–	όπως παραπάνω
related_persons.current[].namestring	Πλήρες όνομα όπως εμφανίζεται στο μητρώο.	`"Paul Musterwald"`	όπως παραπάνω
related_persons.current[].name_partsobject	Το όνομα χωρισμένο στα μέρη του, για ταξινόμηση και αντιστοίχιση.	–	όπως παραπάνω
related_persons.current[].name_parts.givenstring\|null	Μικρό όνομα, όλα αν είναι περισσότερα.	`"Paul"`	όπως παραπάνω
related_persons.current[].name_parts.familystring\|null	Επώνυμο.	`"Musterwald"`	όπως παραπάνω
related_persons.current[].name_parts.canonical_namestring\|null	Το όνομα, συνήθως στη μορφή «Επώνυμο, Όνομα», για ταξινόμηση και αντιστοίχιση.	`"Musterwald, Paul"`	όπως παραπάνω
related_persons.current[].name_parts.maidenstring\|null	Επώνυμο γέννησης.Κενό όταν δεν είναι καταχωρισμένο	`null`	σπάνια
related_persons.current[].name_parts.previous_namesarray\|null	Προηγούμενα ονόματα του προσώπου ως λίστα.Κενό όταν δεν είναι καταχωρισμένα	`null`	όπως παραπάνω
related_persons.current[].titlesarray	Ακαδημαϊκοί τίτλοι, για παράδειγμα Dr. Το κλειδί λείπει αν δεν είναι καταχωρισμένος τίτλος.	–	όπως παραπάνω
related_persons.current[].birth_datestring\|null	Ημερομηνία γέννησης στη μορφή YYYY-MM-DD, όπως είναι καταχωρισμένη.Κενό όταν δεν είναι καταχωρισμένη ημερομηνία	`"1989-07-18"`	συνήθως
related_persons.current[].locationobject\|null	Τόποι του προσώπου.	–	όπως παραπάνω
related_persons.current[].location.home.citystring\|null	Τόπος κατοικίας, όπως είναι καταχωρισμένος. Το μητρώο δεν περιέχει πλήρη διεύθυνση.Κενό όταν δεν είναι καταχωρισμένος τόπος κατοικίας	`"Exempelingen i. Bay."`	όπως παραπάνω
related_persons.current[].start_datestring\|null	Έναρξη του ρόλου στη μορφή YYYY-MM-DD.Κενό όταν η έναρξη δεν είναι γνωστή, για παράδειγμα με Πραγματικό χρόνο	`"2019-01-04"`	όπως παραπάνω
related_persons.current[].end_datestring\|null	Λήξη του ρόλου. Συμπληρώνεται για τα πρόσωπα στο past.Κενό όταν ο ρόλος υφίσταται ακόμη	`null`	πάντα

Διαχειριστές και διοικητικό συμβούλιο

Οι διαχειριστές (Geschäftsführer) μιας GmbH ή UG έχουν το label MANAGING_DIRECTOR. Το διοικητικό συμβούλιο (Vorstand) μιας AG, SE ή eG το αναγνωρίζεις από το BOARD, τον πρόεδρό του από το BOARD_CHAIR. Όταν μια εταιρεία λύεται, την εκπροσώπηση αναλαμβάνουν εκκαθαριστές με LIQUIDATOR.

Έλεγχε πάντα τους ρόλους μέσω του label. Τα κείμενα στο role προορίζονται για εμφάνιση.

Prokura

Η Prokura είναι η καταχωρισμένη πληρεξουσιότητα για την εκπροσώπηση της εταιρείας σε σχεδόν όλες τις συναλλαγές. Οι κάτοχοι Prokura (Prokuristen) έχουν το label PROCURA. Αν κάποιος μπορεί να ενεργεί μόνος ή μόνο από κοινού με άλλους αναγράφεται στο role_representation_scheme, για παράδειγμα «Gesamtprokura gemeinsam mit einem Vorstandsmitglied» (συλλογική Prokura από κοινού με ένα μέλος του ΔΣ).

Ομόρρυθμοι εταίροι

Σε μια KG, OHG και KGaA, την εταιρεία εκπροσωπούν οι ομόρρυθμοι εταίροι (persönlich haftende Gesellschafter). Έχουν το label FULLY_LIABLE_PARTNER. Οι ετερόρρυθμοι εταίροι (Kommanditisten) μιας KG είναι στο μητρώο με LIMITED_PARTNER, ο ιδιοκτήτης μιας e.K. με OWNER, οι εταίροι μιας PartG ή eGbR με PARTNER.

Σε μια GmbH & Co. KG, ο ομόρρυθμος εταίρος είναι συνήθως η ίδια μια GmbH. Τους διαχειριστές της τους βρίσκεις στο προφίλ εταιρείας αυτής της GmbH.

Ρόλοι ανά νομική μορφή

Ποιους ρόλους έχει μια εταιρεία προκύπτει από τη νομική της μορφή. Ο πίνακας δείχνει ποια labels βλέπεις συνήθως ανά νομική μορφή. Όλα τα labels με τη σημασία τους παρατίθενται παραπάνω στο label.

Νομική μορφή
Νομική μορφή	Συνήθη labels
GmbH, UG	MANAGING_DIRECTOR, PROCURA, σε εκκαθάριση LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, για KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Εξουσία εκπροσώπησης

Κάθε πρόσωπο συνοδεύεται από δύο σύνολα κανόνων. Το role_representation_scheme είναι η δική του εξουσία, για παράδειγμα «einzelvertretungsberechtigt» (μπορεί να εκπροσωπεί μόνο του). Το organization_representation_scheme είναι ο γενικός κανόνας της εταιρείας, ίδιος με το representation_scheme στα βασικά στοιχεία. Και τα δύο έχουν current και history· για πρώην πρόσωπα, το latest αντικαθιστά το current.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
related_persons.current[].role_representation_schemeobject	Η δική του εξουσία εκπροσώπησης του προσώπου, για παράδειγμα «einzelvertretungsberechtigt» (μπορεί να εκπροσωπεί μόνο του) ή απαλλαγή από την § 181 BGB. Το current είναι η ισχύουσα εκδοχή, το history οι μεταβολές με value, effective_from και effective_to.`related_persons`	–	συνήθως: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG σπάνια: e.K.
related_persons.current[].organization_representation_schemeobject	Οι γενικοί κανόνες εκπροσώπησης της εταιρείας, που συνοδεύουν κάθε πρόσωπο. Με την ίδια δομή όπως το role_representation_scheme.	–	πάντα: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG συνήθως: AG, SE, KGaA, e.K.

Πρόσωπα με Πραγματικό χρόνο

Με realtime_mode=handelsregister-default, τα πρόσωπα που είναι εγγεγραμμένα αυτή τη στιγμή έρχονται απευθείας από το Handelsregister (εμπορικό μητρώο), ακόμη και χωρίς το feature related_persons. Τότε χρεώνεται μόνο ο Πραγματικός χρόνος, όχι το feature. Η απάντηση περιέχει μόνο το current.

Σε αυτή τη λίστα, τα start_date και end_date είναι κενά, τα ονόματα μπορεί να είναι συντομότερα και το entity_id ενός προσώπου μπορεί να διαφέρει από εκείνο χωρίς Πραγματικό χρόνο. Αντιστοίχισε τα πρόσωπα με όνομα και ημερομηνία γέννησης.

Αν ζητήσεις μαζί Πραγματικό χρόνο και related_persons, το current προέρχεται από το ζωντανό ερώτημα και το past από το προφίλ εταιρείας. Τότε χρεώνεται και το feature.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
related_persons.current[].name_parts.aliasesarray	Γραφές του ονόματος από το ζωντανό ερώτημα, στη μορφή «Επώνυμο, Όνομα». Μόνο με Πραγματικό χρόνο.`related_persons`	–	πάντα

Προφίλ προσώπου

Το προφίλ προσώπου (fetch-person) περιγράφει ένα μεμονωμένο πρόσωπο: τους ρόλους του σε όλες τις εταιρείες με τις οποίες συνδέεται και τι λένε γι’ αυτό δημόσιες πηγές στο διαδίκτυο. Βρίσκεις το πρόσωπο με το όνομά του και μια εταιρεία στην οποία έχει ή είχε κάποιον ρόλο.

Το προφίλ προσώπου περιλαμβάνεται σε κάθε συνδρομή πιστώσεων από το Plus. Ένα αίτημα διαρκεί συχνά δέκα έως τριάντα δευτερόλεπτα, γιατί κάνουμε έρευνα στο διαδίκτυο. Όρισε το timeout του client σου σε τουλάχιστον 120 δευτερόλεπτα.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'person_q=Max Mustermann' \
  --data-urlencode 'organization_q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-person",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "person_q": "Max Mustermann",
        "organization_q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-person");
url.searchParams.append("person_q", "Max Mustermann");
url.searchParams.append("organization_q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "entity_id": "08ed5f967956831ca6588930fd2693ed",3  "name": "Max Felix Mustermann",4  "birth_date": "1976-01-15",5  "name_parts": {6    "given": "Max Felix",7    "family": "Mustermann",8    "maiden": null,9    "canonical_name": "Mustermann, Max Felix",10    "previous_names": null11  },12  "location": {13    "home": {14      "city": "Musterheim"15    }16  },17  "bio": "Max Felix Mustermann ist Geschäftsführer der Hetzner Online GmbH und Unternehmer im Bereich Rechenzentren.",18  "expertise": [19    "Rechenzentren",20    "Hosting"21  ],22  "contact": {23    "emails": [24      {25        "address": "[email protected]",26        "type": "organization",27        "label": "Allgemeine Unternehmenskontakt-E-Mail"28      },29      {30        "address": "[email protected]",31        "type": "organization",32        "label": "E-Mail für Produktfeedback"33      }34    ],35    "phones": [36      {37        "number": "+49374574447100",38        "type": "organization",39        "entity": "Hetzner Online GmbH",40        "label": "Öffentliche Unternehmens-Telefonnummer"41      },42      {43        "number": "+49911234226100",44        "type": "organization",45        "entity": "Hetzner Online GmbH",46        "label": "Öffentliche Unternehmens-Telefonnummer"47      },48      {49        "number": "+4998315050",50        "type": "organization",51        "entity": "Hetzner Online GmbH",52        "label": "Zentrale Unternehmensnummer"53      }54    ]55  },56  "profiles": {57    "linkedin": null,58    "other": []59  },60  "affiliations": [61    {62      "organization": "ENSoXX Holding AG",63      "relation": "Vorstandsmitglied"64    },65    {66      "organization": "Hetzner Online GmbH",67      "relation": "Geschäftsführer"68    },69    {70      "organization": "ENSoXX hilft e.V.",71      "relation": "Vorstandsmitglied"72    },73    {74      "organization": "TRAIDY UG (haftungsbeschränkt)",75      "relation": "Geschäftsführer"76    },77    {78      "organization": "HT clean energy GmbH",79      "relation": "Geschäftsführer"80    },81    {82      "organization": "DreamSoXX GmbH",83      "relation": "Geschäftsführer"84    },85    {86      "organization": "Lighthouse GmbH",87      "relation": "Prokura"88    },89    {90      "organization": "ENSoXX GmbH",91      "relation": "Geschäftsführer"92    },93    {94      "organization": "ENSoXX Invest GmbH",95      "relation": "Geschäftsführer"96    },97    {98      "organization": "Sonnenkraft Merkendorf GmbH & Co. KG",99      "relation": "Kommanditist"100    },101    {102      "organization": "Modellsportclub Gunzenhausen e.V.",103      "relation": "Vorstandsmitglied"104    },105    {106      "organization": "possum Projekt 1 GmbH",107      "relation": "Prokura"108    }109  ],110  "handelsregister_roles": [111    {112      "entity_id": "94eb910fef13f94585c48c263fa446d4",113      "name": "Hetzner Online GmbH",114      "label": "BOARD",115      "role": {116        "en": "Board Member",117        "de": "Vorstandsmitglied"118      },119      "start_date": "2002-10-15",120      "end_date": "2015-07-28"121    },122    {123      "entity_id": "0b3435f83ce8591300625100815d4583",124      "name": "Hetzner Online GmbH",125      "label": "BOARD",126      "role": {127        "en": "Board Member",128        "de": "Vorstandsmitglied"129      },130      "start_date": "2002-10-15",131      "end_date": "2015-07-28"132    },133    {134      "entity_id": "0b3435f83ce8591300625100815d4583",135      "name": "Hetzner Online GmbH",136      "label": "MANAGING_DIRECTOR",137      "role": {138        "en": "Managing Director",139        "de": "Geschäftsführer"140      },141      "start_date": "2015-07-28",142      "end_date": null143    },144    {145      "entity_id": "94eb910fef13f94585c48c263fa446d4",146      "name": "Hetzner Online GmbH",147      "label": "MANAGING_DIRECTOR",148      "role": {149        "en": "Managing Director",150        "de": "Geschäftsführer"151      },152      "start_date": "2015-07-28",153      "end_date": null154    },155    {156      "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",157      "name": "ENSoXX GmbH",158      "label": "MANAGING_DIRECTOR",159      "role": {160        "en": "Managing Director",161        "de": "Geschäftsführer"162      },163      "start_date": "2015-08-14",164      "end_date": null165    },166    {167      "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",168      "name": "ENSoXX Holding AG",169      "label": "BOARD",170      "role": {171        "en": "Board Member",172        "de": "Vorstandsmitglied"173      },174      "start_date": "2016-02-03",175      "end_date": null176    },177    {178      "entity_id": "bc1c1e106ade810eb960c779d4c752a8",179      "name": "ENSoXX hilft e.V.",180      "label": "BOARD",181      "role": {182        "en": "Board Member",183        "de": "Vorstandsmitglied"184      },185      "start_date": "2017-02-24",186      "end_date": null187    },188    {189      "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",190      "name": "TRAIDY UG (haftungsbeschränkt)",191      "label": "MANAGING_DIRECTOR",192      "role": {193        "en": "Managing Director",194        "de": "Geschäftsführer"195      },196      "start_date": "2022-03-14",197      "end_date": null198    },199    {200      "entity_id": "4cd425f9ad57d6119f704ba53131b480",201      "name": "Modellsportclub Gunzenhausen e.V.",202      "label": "BOARD",203      "role": {204        "en": "Board Member",205        "de": "Vorstandsmitglied"206      },207      "start_date": "2023-06-06",208      "end_date": "2026-08-12"209    },210    {211      "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",212      "name": "ENSoXX Invest GmbH",213      "label": "MANAGING_DIRECTOR",214      "role": {215        "en": "Managing Director",216        "de": "Geschäftsführer"217      },218      "start_date": "2023-12-13",219      "end_date": null220    },221    {222      "entity_id": "2ab71b59057969183dd811adf9f32ebd",223      "name": "HT clean energy GmbH",224      "label": "MANAGING_DIRECTOR",225      "role": {226        "en": "Managing Director",227        "de": "Geschäftsführer"228      },229      "start_date": "2024-08-20",230      "end_date": null231    },232    {233      "entity_id": "260286ab8baa3a8977fddd56b9361c6c",234      "name": "DreamSoXX GmbH",235      "label": "MANAGING_DIRECTOR",236      "role": {237        "en": "Managing Director",238        "de": "Geschäftsführer"239      },240      "start_date": "2025-01-13",241      "end_date": null242    },243    {244      "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",245      "name": "Lighthouse GmbH",246      "label": "PROCURA",247      "role": {248        "en": "Procura",249        "de": "Prokura"250      },251      "start_date": "2025-03-25",252      "end_date": null253    },254    {255      "entity_id": "232d2ed634eef59eb21836cc47cb5645",256      "name": "Sonnenkraft Merkendorf GmbH & Co. KG",257      "label": "LIMITED_PARTNER",258      "role": {259        "en": "Limited Partner",260        "de": "Kommanditist"261      },262      "start_date": "2026-02-18",263      "end_date": null264    },265    {266      "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",267      "name": "possum Projekt 1 GmbH",268      "label": "PROCURA",269      "role": {270        "en": "Procura",271        "de": "Prokura"272      },273      "start_date": "2026-09-04",274      "end_date": null275    },276    {277      "entity_id": "997f1b8314b8b56573208ae2334abb1d",278      "name": "possum Projekt 1 GmbH",279      "label": "PROCURA",280      "role": {281        "en": "Procura",282        "de": "Prokura"283      },284      "start_date": "2026-09-04",285      "end_date": null286    }287  ],288  "meta": {289    "request_credit_cost": 15,290    "credits_remaining": 145291  }292}

200 · Παράδειγμα απάντησης: προφίλ προσώπου του Max Felix Mustermann (δείγμα δεδομένων) στη Hetzner Online GmbH, συντομευμένο

Το πρόσωπο

Το όνομα, η ημερομηνία γέννησης και ο τόπος κατοικίας προέρχονται από το μητρώο. Το entity_id είναι το ίδιο με εκείνο στο related_persons των προφίλ εταιρειών χωρίς Πραγματικό χρόνο.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
entity_idstring	ID του προσώπου. Το ίδιο ID εμφανίζεται στο related_persons των προφίλ εταιρειών χωρίς Πραγματικό χρόνο.Προφίλ προσώπου	`"08ed5f967956831ca6588930fd2693ed"`	πάντα
namestring	Πλήρες όνομα όπως εμφανίζεται στο μητρώο.	`"Max Felix Mustermann"`	όπως παραπάνω
birth_datestring\|null	Ημερομηνία γέννησης στη μορφή YYYY-MM-DD, όπως είναι καταχωρισμένη.Κενό όταν δεν είναι καταχωρισμένη ημερομηνία	`"1976-01-15"`	συνήθως
name_partsobject	Το όνομα χωρισμένο στα μέρη του, με την ίδια δομή όπως στο related_persons.	–	πάντα
name_parts.givenstring\|null	Μικρό όνομα, όλα αν είναι περισσότερα.	`"Max Felix"`	όπως παραπάνω
name_parts.familystring\|null	Επώνυμο.	`"Mustermann"`	όπως παραπάνω
name_parts.canonical_namestring\|null	Το όνομα, συνήθως στη μορφή «Επώνυμο, Όνομα», για ταξινόμηση και αντιστοίχιση.	`"Mustermann, Max Felix"`	όπως παραπάνω
name_parts.maidenstring\|null	Επώνυμο γέννησης.Κενό όταν δεν είναι καταχωρισμένο	`null`	σπάνια
name_parts.previous_namesarray\|null	Προηγούμενα ονόματα του προσώπου ως λίστα.Κενό όταν δεν είναι καταχωρισμένα	`null`	όπως παραπάνω
locationobject	Τόποι του προσώπου.	–	συνήθως
location.home.citystring\|null	Τόπος κατοικίας, όπως είναι καταχωρισμένος.Κενό όταν δεν είναι καταχωρισμένος τόπος κατοικίας	`"Musterheim"`	όπως παραπάνω

Ρόλοι και συνδέσεις

Το handelsregister_roles απαριθμεί κάθε καταχωρισμένο ρόλο του προσώπου με την εταιρεία και τη χρονική του διάρκεια. Με το entity_id μιας εταιρείας ανακτάς το προφίλ εταιρείας της. Το affiliations συνοψίζει σύντομα τις συνδέσεις, από το μητρώο και το διαδίκτυο.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
handelsregister_rolesarray	Οι καταχωρισμένοι ρόλοι του προσώπου με εταιρεία και χρονική διάρκεια, τρέχοντες και πρώην.Προφίλ προσώπου	–	πάντα
handelsregister_roles[].entity_idstring	entity_id της εταιρείας, για ένα προφίλ εταιρείας στην παράμετρο q.	`"0b3435f83ce8591300625100815d4583"`	όπως παραπάνω
handelsregister_roles[].namestring	Επωνυμία της εταιρείας.	`"Hetzner Online GmbH"`	όπως παραπάνω
handelsregister_roles[].labelstring	Ρόλος ως σταθερή τιμή, οι ίδιες τιμές όπως το label στο related_persons, για παράδειγμα MANAGING_DIRECTOR, BOARD, PROCURA ή LIMITED_PARTNER.	`"BOARD"`	όπως παραπάνω
handelsregister_roles[].roleobject	Ονομασία ρόλου για εμφάνιση, ως κείμενο σε de και en.	–	όπως παραπάνω
handelsregister_roles[].start_datestring\|null	Έναρξη του ρόλου στη μορφή YYYY-MM-DD.Κενό όταν η έναρξη δεν είναι γνωστή	`"2002-10-15"`	συνήθως
handelsregister_roles[].end_datestring\|null	Λήξη του ρόλου.Κενό όταν ο ρόλος υφίσταται ακόμη	`"2015-07-28"`	πάντα
affiliationsarray	Οι εταιρείες με τις οποίες συνδέεται το πρόσωπο, η καθεμία με το είδος της σύνδεσης. Συνοψίζεται από το μητρώο και πηγές στο διαδίκτυο.	–	όπως παραπάνω
affiliations[].organizationstring	Επωνυμία της εταιρείας.	`"ENSoXX Holding AG"`	όπως παραπάνω
affiliations[].relationstring	Είδος σύνδεσης ως γερμανικό κείμενο, για παράδειγμα Geschäftsführer (διαχειριστής), Prokura ή Kommanditist (ετερόρρυθμος εταίρος).	`"Vorstandsmitglied"`	όπως παραπάνω

Έρευνα στο διαδίκτυο

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

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
biostring\|null	Σύντομο βιογραφικό του προσώπου σε μία ή δύο προτάσεις, στα γερμανικά.Κενό όταν το διαδίκτυο έχει πολύ λίγα για το πρόσωπο (τότε null)Προφίλ προσώπου	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	συνήθως
expertisearray	Τομείς εξειδίκευσης και θέματα του προσώπου ως λίστα.Κενό όταν το διαδίκτυο έχει πολύ λίγα για το πρόσωπο	–	όπως παραπάνω
contactobject	Δημόσια αναρτημένα κανάλια επικοινωνίας, με emails και phones.	–	πάντα
contact.emailsarray	Διευθύνσεις email ως λίστα.Κενό όταν δεν βρέθηκε διεύθυνση	–	σπάνια
contact.emails[].addressstring	Η διεύθυνση email.	`"[email protected]"`	όπως παραπάνω
contact.emails[].typestring	Είδος διεύθυνσης. organization σημαίνει: διεύθυνση της εταιρείας, όχι ιδιωτική.	`"organization"`	όπως παραπάνω
contact.emails[].labelstring	Σε τι χρησιμεύει η διεύθυνση, ως σύντομο κείμενο.	`"Allgemeine Unternehmenskontakt-E-Mail"`	όπως παραπάνω
contact.phonesarray	Αριθμοί τηλεφώνου ως λίστα.Κενό όταν δεν βρέθηκε αριθμός	–	όπως παραπάνω
contact.phones[].numberstring	Ο αριθμός, συνήθως σε διεθνή μορφή.	`"+49374574447100"`	όπως παραπάνω
contact.phones[].typestring	Είδος αριθμού. organization σημαίνει: αριθμός της εταιρείας.	`"organization"`	όπως παραπάνω
contact.phones[].entitystring	Η εταιρεία στην οποία ανήκει ο αριθμός.	`"Hetzner Online GmbH"`	όπως παραπάνω
contact.phones[].labelstring	Σε τι χρησιμεύει ο αριθμός, για παράδειγμα τηλεφωνικό κέντρο ή fax.	`"Öffentliche Unternehmens-Telefonnummer"`	όπως παραπάνω
profilesobject	Ιστοσελίδες για το πρόσωπο, με linkedin και other.	–	πάντα
profiles.linkedinstring\|null	Διεύθυνση του προφίλ LinkedIn.Κενό όταν δεν βρέθηκε	`null`	σπάνια
profiles.otherarray	Άλλες σελίδες για το πρόσωπο, για παράδειγμα άρθρα τύπου ή σελίδες ομάδας, ως λίστα διευθύνσεων.Κενό όταν δεν βρέθηκαν	–	συνήθως

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

Συμμετοχές και δίκτυο

Δύο features επεκτείνουν το προφίλ προσώπου: το shareholdings δείχνει τις εταιρείες στις οποίες συμμετέχει το πρόσωπο. Το network δείχνει τις εταιρείες και τα πρόσωπα με τα οποία συνδέεται, σε δύο επίπεδα. Και τα δύο χρεώνονται μόνο αν επιστρέφουν δεδομένα.

Πεδίο
Πεδίο	Σημασία	Παράδειγμα	Διαθεσιμότητα
shareholdingsobject\|null	Εταιρείες στις οποίες συμμετέχει σήμερα το πρόσωπο.Κενό όταν δεν είναι γνωστή καμία συμμετοχή`shareholdings`	–	εν μέρει
shareholdings.holdings.currentarray	Οι τρέχουσες συμμετοχές ως λίστα.	–	όπως παραπάνω
shareholdings.holdings.current[].organizationobject	Η εταιρεία με entity_id, name, status, legal_form, address και registration, με την ίδια δομή όπως στα βασικά στοιχεία.	–	όπως παραπάνω
shareholdings.holdings.current[].ownership.percentagenumber\|null	Μερίδιο στο κεφάλαιο σε ποσοστό, για παράδειγμα 33.33.	`100`	όπως παραπάνω
shareholdings.holdings.current[].ownership.contributionobject\|null	Ονομαστικό ποσό της συμμετοχής με amount και currency.	–	όπως παραπάνω
shareholdings.holdings.current[].as_ofstring\|null	Ημερομηνία της πληροφορίας στη μορφή YYYY-MM-DD.	`"2025-01-13"`	όπως παραπάνω
shareholdings.summary.total_currentinteger	Πλήθος τρεχουσών συμμετοχών.	`3`	όπως παραπάνω
networkobject\|null	Εταιρείες και πρόσωπα με τα οποία συνδέεται το πρόσωπο, σε δύο επίπεδα. Με την ίδια δομή όπως το network στο προφίλ εταιρείας.`network` · από Pro · Beta	–	συνήθως
network.depthinteger	Πόσα επίπεδα καλύπτει το δίκτυο, μετρώντας από το πρόσωπο. Το ίδιο το πρόσωπο είναι το επίπεδο 0.	`2`	όπως παραπάνω
network.nodesarray	Οι κόμβοι: πρόσωπα (PERSON) και εταιρείες (ORGANIZATION) με entity_id, name και το επίπεδό τους. Το ίδιο το πρόσωπο έχει is_root true.	–	όπως παραπάνω
network.connectionsarray	Οι συνδέσεις μεταξύ δύο κόμβων, η καθεμία με kind (ROLE, OWNERSHIP ή GROUP), label, χρονική διάρκεια και is_current.	–	όπως παραπάνω

Συνέχεια

fetch-organization Το endpoint με το feature related_persons και τον Πραγματικό χρόνο. fetch-person Ανάκτηση του προφίλ προσώπου: παράμετροι, κόστος και σφάλματα. Εύρεση διαχειριστών και εταίρων Βήμα βήμα από την εταιρεία στα πρόσωπά της. Εταίροι και συμμετοχές Σε ποιον ανήκει μια εταιρεία και σε ποιες εταιρείες συμμετέχει.