Személyek és képviselet – Dokumentáció

Személyek lekérése

Kérd a related_persons funkciót. A válasz ekkor tartalmazza a related_persons kulcsot két listával: a current mindenkit, aki ma betölti a szerepét, a past mindenkit, aki távozott. Minden szerep külön bejegyzés. A Hetzner Online GmbH-ra (Ansbach HRB 6089) vonatkozó példakérésünkben a current három ügyvezetőt tartalmazott. Közülük ketten a korábbi Prokurájukkal a past listában is megjelentek. A példaválaszokban minden személyes adat mintaadat.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: AZ_API_KULCSOD" \
  --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": "AZ_API_KULCSOD"},
    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": "AZ_API_KULCSOD" },
});
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 · Példaválasz: a Hetzner Online GmbH a related_persons funkcióval, névre és személyekre rövidítve

Mező
Mező	Jelentés	Példa	Elérhetőség
related_personsobject\|null	A cég összes bejegyzett személye, current és past szerint felosztva.`related_persons`	–	mindig
related_persons.currentarray	Személyek, akik ma betöltik a szerepüket.	–	mint fent
related_persons.pastarray	Távozott személyek, ugyanazokkal a mezőkkel, mint a current. A két képviseleti szabályban a latest lép a current helyére: a távozás előtti utolsó változat.Üres, ha a bejegyzés óta senki nem távozott	–	többnyire

Egy személy mezői

A current és a past minden bejegyzésének ugyanazok a mezői vannak. Valós idejű mód nélkül egy személynek minden cégprofilban és a személyprofilban ugyanaz az entity_id-ja. Így cégeken átívelően felismered. A valós idejű lekérdezésből származó személyeknek saját azonosítóik vannak.

Mező
Mező	Jelentés	Példa	Elérhetőség
related_persons.current[].entity_idstring\|null	A személy azonosítója. Valós idejű mód nélkül minden cégprofilban ugyanaz, és megegyezik a személyprofil entity_id-jával.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	mindig
related_persons.current[].labelstring	Szerep rögzített értékként. Más értékek is lehetségesek.Értékek: `MANAGING_DIRECTOR` ügyvezető (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` bíróság által kirendelt ügyvezető (Notgeschäftsführer), `BOARD` az igazgatóság tagja (Vorstand), `BOARD_CHAIR` az igazgatóság elnöke, `DIRECTOR` ügyvezető igazgató, például egy SE-nél, `PROCURA` prokurista (Prokurist), `LIQUIDATOR` felszámoló, `INSOLVENCY_ADMINISTRATOR` csődgondnok, `REPRESENTATIVE` állandó képviselő, `FULLY_LIABLE_PARTNER` korlátlanul felelős tag (persönlich haftender Gesellschafter), `LIMITED_PARTNER` kültag (Kommanditist), `PARTNER` partner, `OWNER` tulajdonos (Inhaber), `PROPRIETOR` tulajdonos (Inhaber), `TREASURER` egy egyesület pénztárosa, `SECRETARY` egy egyesület titkára, `YOUTH_WARDEN` egy egyesület ifjúsági felelőse, `WATER_WARDEN` egy egyesület vízügyi felelőse, `OTHER` egyéb szerep	`"MANAGING_DIRECTOR"`	mint fent
related_persons.current[].roleobject	Szerepnév megjelenítéshez, de és en nyelven, mindkettő hosszan (long) és röviden (short), például Geschäftsführer és GF.	–	mint fent
related_persons.current[].namestring	Teljes név, ahogy a nyilvántartásban szerepel.	`"Paul Musterwald"`	mint fent
related_persons.current[].name_partsobject	A név részekre bontva, rendezéshez és párosításhoz.	–	mint fent
related_persons.current[].name_parts.givenstring\|null	Utónév, több esetén mindegyik.	`"Paul"`	mint fent
related_persons.current[].name_parts.familystring\|null	Családnév.	`"Musterwald"`	mint fent
related_persons.current[].name_parts.canonical_namestring\|null	A név, általában „Családnév, Utónév” formában, rendezéshez és párosításhoz.	`"Musterwald, Paul"`	mint fent
related_persons.current[].name_parts.maidenstring\|null	Születési név.Üres, ha nincs bejegyezve	`null`	ritkán
related_persons.current[].name_parts.previous_namesarray\|null	A személy korábbi nevei listaként.Üres, ha nincsenek bejegyezve	`null`	mint fent
related_persons.current[].titlesarray	Tudományos címek, például Dr. A kulcs hiányzik, ha nincs bejegyzett cím.	–	mint fent
related_persons.current[].birth_datestring\|null	Születési dátum YYYY-MM-DD formátumban, ahogy bejegyezték.Üres, ha nincs bejegyzett dátum	`"1989-07-18"`	többnyire
related_persons.current[].locationobject\|null	A személy helyei.	–	mint fent
related_persons.current[].location.home.citystring\|null	Lakóhely, ahogy bejegyezték. A nyilvántartás nem tartalmaz teljes címet.Üres, ha nincs bejegyzett lakóhely	`"Exempelingen i. Bay."`	mint fent
related_persons.current[].start_datestring\|null	A szerep kezdete YYYY-MM-DD formátumban.Üres, ha a kezdet nem ismert, például valós idejű módnál	`"2019-01-04"`	mint fent
related_persons.current[].end_datestring\|null	A szerep vége. A past listában lévő személyeknél van kitöltve.Üres, ha a szerep még fennáll	`null`	mindig

Ügyvezetők és igazgatóság

Egy GmbH vagy UG ügyvezetőinek (Geschäftsführer) a címkéje MANAGING_DIRECTOR. Egy AG, SE vagy eG igazgatóságát (Vorstand) a BOARD, az elnökét a BOARD_CHAIR alapján ismered fel. Ha egy cég megszűnik, a képviseletet LIQUIDATOR címkéjű felszámolók veszik át.

A szerepeket mindig a label alapján ellenőrizd. A role szövegei megjelenítésre szolgálnak.

Prokura

A Prokura a nyilvántartásba bejegyzett meghatalmazás, amely szinte minden ügyletben feljogosít a cég képviseletére. A prokuristák (Prokuristen) címkéje PROCURA. Hogy valaki önállóan vagy csak másokkal együtt járhat-e el, az a role_representation_scheme mezőben áll, például „Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (együttes Prokura egy igazgatósági taggal).

Korlátlanul felelős tagok

A KG-ban, az OHG-ban és a KGaA-ban a korlátlanul felelős tagok (persönlich haftende Gesellschafter) képviselik a céget. Címkéjük FULLY_LIABLE_PARTNER. Egy KG kültagjai (Kommanditisten) LIMITED_PARTNER, egy e.K. tulajdonosa OWNER, egy PartG vagy eGbR partnerei PARTNER címkével szerepelnek a nyilvántartásban.

Egy GmbH & Co. KG-ban a korlátlanul felelős tag általában maga is egy GmbH. Az ügyvezetőit annak a GmbH-nak a cégprofiljában találod.

Szerepek jogi formánként

Hogy egy cégnek milyen szerepei vannak, az a jogi formájából következik. A táblázat mutatja, milyen címkéket látsz jellemzően jogi formánként. Az összes címke a jelentésével fent, a label alatt szerepel.

Jogi forma
Jogi forma	Jellemző címkék
GmbH, UG	MANAGING_DIRECTOR, PROCURA, felszámolás alatt LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, KG-nál LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Képviseleti jogkör

Minden személy két szabálykészlettel érkezik. A role_representation_scheme a saját jogköre, például „einzelvertretungsberechtigt” (önálló képviseleti joggal rendelkezik). Az organization_representation_scheme a cég általános szabálya, ugyanaz, mint a representation_scheme az alapadatokban. Mindkettőnek van current és history mezője; a korábbi személyeknél a latest lép a current helyére.

Mező
Mező	Jelentés	Példa	Elérhetőség
related_persons.current[].role_representation_schemeobject	A személy saját képviseleti jogköre, például „einzelvertretungsberechtigt” (önálló képviseleti joggal rendelkezik) vagy felmentés a § 181 BGB alól. A current a hatályos változat, a history a változások value, effective_from és effective_to mezővel.`related_persons`	–	többnyire: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG ritkán: e.K.
related_persons.current[].organization_representation_schemeobject	A cég általános képviseleti szabályai, minden személynél mellékelve. Felépítése olyan, mint a role_representation_scheme mezőé.	–	mindig: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG többnyire: AG, SE, KGaA, e.K.

Személyek valós idejű móddal

A realtime_mode=handelsregister-default paraméterrel a jelenleg bejegyzett személyek közvetlenül a Handelsregisterből jönnek, a related_persons funkció nélkül is. Ilyenkor csak a valós idejű módot számoljuk fel, a funkciót nem. A válasz csak a current listát tartalmazza.

Ebben a listában a start_date és az end_date üres, a nevek rövidebbek lehetnek, és egy személy entity_id-ja eltérhet a valós idejű mód nélkülitől. A személyeket név és születési dátum alapján párosítsd.

Ha a valós idejű módot és a related_persons funkciót együtt kéred, a current az élő lekérdezésből, a past a cégprofilból származik. Ilyenkor a funkciót is felszámoljuk.

Mező
Mező	Jelentés	Példa	Elérhetőség
related_persons.current[].name_parts.aliasesarray	A név írásmódjai az élő lekérdezésből, „Családnév, Utónév” formában. Csak valós idejű móddal.`related_persons`	–	mindig

Személyprofil

A személyprofil (fetch-person) egyetlen személyt ír le: a szerepeit az összes céggel, amelyhez kapcsolódik, és azt, amit a nyilvános webes források mondanak róla. A személyt a neve és egy olyan cég alapján találod meg, amelyben szerepe van vagy volt.

A személyprofil a Plus csomagtól minden kredit-előfizetéssel elérhető. Egy kérés gyakran tíz-harminc másodpercig tart, mert a weben kutatunk. Állítsd a kliensed időkorlátját legalább 120 másodpercre.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: AZ_API_KULCSOD" \
  --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": "AZ_API_KULCSOD"},
    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": "AZ_API_KULCSOD" },
});
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 · Példaválasz: Max Felix Mustermann (mintaadat) személyprofilja a Hetzner Online GmbH-nál, rövidítve

A személy

A név, a születési dátum és a lakóhely a nyilvántartásból származik. Az entity_id ugyanaz, mint a valós idejű mód nélküli cégprofilok related_persons mezőjében.

Mező
Mező	Jelentés	Példa	Elérhetőség
entity_idstring	A személy azonosítója. Ugyanez az azonosító szerepel a valós idejű mód nélküli cégprofilok related_persons mezőjében.Személyprofil	`"08ed5f967956831ca6588930fd2693ed"`	mindig
namestring	Teljes név, ahogy a nyilvántartásban szerepel.	`"Max Felix Mustermann"`	mint fent
birth_datestring\|null	Születési dátum YYYY-MM-DD formátumban, ahogy bejegyezték.Üres, ha nincs bejegyzett dátum	`"1976-01-15"`	többnyire
name_partsobject	A név részekre bontva, a related_persons mezőhöz hasonló felépítésben.	–	mindig
name_parts.givenstring\|null	Utónév, több esetén mindegyik.	`"Max Felix"`	mint fent
name_parts.familystring\|null	Családnév.	`"Mustermann"`	mint fent
name_parts.canonical_namestring\|null	A név, általában „Családnév, Utónév” formában, rendezéshez és párosításhoz.	`"Mustermann, Max Felix"`	mint fent
name_parts.maidenstring\|null	Születési név.Üres, ha nincs bejegyezve	`null`	ritkán
name_parts.previous_namesarray\|null	A személy korábbi nevei listaként.Üres, ha nincsenek bejegyezve	`null`	mint fent
locationobject	A személy helyei.	–	többnyire
location.home.citystring\|null	Lakóhely, ahogy bejegyezték.Üres, ha nincs bejegyzett lakóhely	`"Musterheim"`	mint fent

Szerepek és kapcsolatok

A handelsregister_roles a személy minden bejegyzett szerepét felsorolja a céggel és az időszakkal. Egy cég entity_id-jával lekérheted a cégprofilját. Az affiliations röviden összefoglalja a kapcsolatokat a nyilvántartásból és a webről.

Mező
Mező	Jelentés	Példa	Elérhetőség
handelsregister_rolesarray	A személy bejegyzett szerepei céggel és időszakkal, jelenlegiek és korábbiak.Személyprofil	–	mindig
handelsregister_roles[].entity_idstring	A cég entity_id-ja, cégprofilhoz a q paraméterben.	`"0b3435f83ce8591300625100815d4583"`	mint fent
handelsregister_roles[].namestring	A cég neve.	`"Hetzner Online GmbH"`	mint fent
handelsregister_roles[].labelstring	Szerep rögzített értékként, ugyanazokkal az értékekkel, mint a label a related_persons mezőben, például MANAGING_DIRECTOR, BOARD, PROCURA vagy LIMITED_PARTNER.	`"BOARD"`	mint fent
handelsregister_roles[].roleobject	Szerepnév megjelenítéshez, szövegként de és en nyelven.	–	mint fent
handelsregister_roles[].start_datestring\|null	A szerep kezdete YYYY-MM-DD formátumban.Üres, ha a kezdet nem ismert	`"2002-10-15"`	többnyire
handelsregister_roles[].end_datestring\|null	A szerep vége.Üres, ha a szerep még fennáll	`"2015-07-28"`	mindig
affiliationsarray	A cégek, amelyekhez a személy kapcsolódik, mindegyik a kapcsolat fajtájával. Nyilvántartási és webes forrásokból összefoglalva.	–	mint fent
affiliations[].organizationstring	A cég neve.	`"ENSoXX Holding AG"`	mint fent
affiliations[].relationstring	A kapcsolat fajtája német szövegként, például Geschäftsführer (ügyvezető), Prokura vagy Kommanditist (kültag).	`"Vorstandsmitglied"`	mint fent

Webes kutatás

A rövid életrajzot, a szakterületeket, az elérhetőségi csatornákat és a forrásokat nyilvános webes forrásokból gyűjtjük. Hogy mennyi létezik belőlük, az attól függ, mennyire látható a személy a weben.

Mező
Mező	Jelentés	Példa	Elérhetőség
biostring\|null	A személy rövid életrajza egy-két mondatban, németül.Üres, ha a weben túl kevés található a személyről (ekkor null)Személyprofil	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	többnyire
expertisearray	A személy szakterületei és témái listaként.Üres, ha a weben túl kevés található a személyről	–	mint fent
contactobject	Nyilvánosan feltüntetett elérhetőségi csatornák, emails és phones mezővel.	–	mindig
contact.emailsarray	E-mail-címek listaként.Üres, ha nem találtunk címet	–	ritkán
contact.emails[].addressstring	Az e-mail-cím.	`"[email protected]"`	mint fent
contact.emails[].typestring	A cím fajtája. Az organization jelentése: a cég címe, nem magáncím.	`"organization"`	mint fent
contact.emails[].labelstring	Mire szolgál a cím, rövid szövegként.	`"Allgemeine Unternehmenskontakt-E-Mail"`	mint fent
contact.phonesarray	Telefonszámok listaként.Üres, ha nem találtunk számot	–	mint fent
contact.phones[].numberstring	A szám, általában nemzetközi formátumban.	`"+49374574447100"`	mint fent
contact.phones[].typestring	A szám fajtája. Az organization jelentése: a cég száma.	`"organization"`	mint fent
contact.phones[].entitystring	A cég, amelyhez a szám tartozik.	`"Hetzner Online GmbH"`	mint fent
contact.phones[].labelstring	Mire szolgál a szám, például központ vagy fax.	`"Öffentliche Unternehmens-Telefonnummer"`	mint fent
profilesobject	Weboldalak a személyről, linkedin és other mezővel.	–	mindig
profiles.linkedinstring\|null	A LinkedIn-profil címe.Üres, ha nem találtunk ilyet	`null`	ritkán
profiles.otherarray	Más oldalak a személyről, például sajtócikkek vagy csapatoldalak, címek listájaként.Üres, ha nem találtunk ilyeneket	–	többnyire

Ezeket az információkat egy AI állítja össze nyilvános forrásokból. Ehhez a legújabb technológiát használjuk, és sokat fektetünk a minőségbe; egyes hibák ennek ellenére előfordulhatnak.

Részesedések és hálózat

Két funkció bővíti a személyprofilt: a shareholdings mutatja azokat a cégeket, amelyekben a személynek részesedése van. A network mutatja azokat a cégeket és személyeket, amelyekhez két szinten át kapcsolódik. Mindkettőt csak akkor számoljuk fel, ha adatot ad vissza.

Mező
Mező	Jelentés	Példa	Elérhetőség
shareholdingsobject\|null	Cégek, amelyekben a személynek ma részesedése van.Üres, ha nem ismert részesedés`shareholdings`	–	részben
shareholdings.holdings.currentarray	A jelenlegi részesedések listaként.	–	mint fent
shareholdings.holdings.current[].organizationobject	A cég entity_id, name, status, legal_form, address és registration mezővel, az alapadatokhoz hasonló felépítésben.	–	mint fent
shareholdings.holdings.current[].ownership.percentagenumber\|null	A tőkéből való részesedés százalékban, például 33.33.	`100`	mint fent
shareholdings.holdings.current[].ownership.contributionobject\|null	A részesedés névértéke amount és currency mezővel.	–	mint fent
shareholdings.holdings.current[].as_ofstring\|null	Az információ dátuma YYYY-MM-DD formátumban.	`"2025-01-13"`	mint fent
shareholdings.summary.total_currentinteger	A jelenlegi részesedések száma.	`3`	mint fent
networkobject\|null	Cégek és személyek, amelyekhez a személy két szinten át kapcsolódik. Felépítése olyan, mint a cégprofil network mezőjéé.`network` · Pro csomagtól · Béta	–	többnyire
network.depthinteger	Hány szintet fed le a hálózat, a személytől számítva. Maga a személy a 0. szint.	`2`	mint fent
network.nodesarray	A csomópontok: személyek (PERSON) és cégek (ORGANIZATION) entity_id-val, névvel és a szintjükkel. Magánál a személynél az is_root értéke true.	–	mint fent
network.connectionsarray	Két csomópont közötti kapcsolatok, mindegyik kind (ROLE, OWNERSHIP vagy GROUP), label, időszak és is_current mezővel.	–	mint fent

Tovább

fetch-organization A végpont a related_persons funkcióval és a valós idejű móddal. fetch-person A személyprofil lekérése: paraméterek, költségek és hibák. Ügyvezetők és tagok keresése Lépésről lépésre a cégtől a személyeiig. Tagok és részesedések Kié a cég, és miben van részesedése.