Osoby a zastupování – Dokumentace

Načíst osoby

Vyžádej si funkci related_persons. Odpověď pak obsahuje klíč related_persons se dvěma seznamy: current pro všechny, kdo svou roli zastávají dnes, a past pro všechny, kdo odešli. Každá role je samostatný záznam. V našem ukázkovém požadavku na Hetzner Online GmbH, Ansbach HRB 6089, obsahoval current tři jednatele. Dva z nich se znovu objevili v past se svou dřívější prokurou. Všechny osobní údaje v ukázkových odpovědích jsou ukázková data.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TVUJ_API_KLIC" \
  --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": "TVUJ_API_KLIC"},
    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": "TVUJ_API_KLIC" },
});
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 · Ukázková odpověď: Hetzner Online GmbH s funkcí related_persons, zkráceno na název a osoby

Pole
Pole	Význam	Příklad	Dostupnost
related_personsobject\|null	Všechny zapsané osoby firmy, rozdělené na current a past.`related_persons`	–	vždy
related_persons.currentarray	Osoby, které svou roli zastávají dnes.	–	jako výše
related_persons.pastarray	Osoby, které odešly, se stejnými poli jako current. V obou pravidlech zastupování nahrazuje current pole latest: poslední znění před odchodem.Prázdné, když od zápisu nikdo neodešel	–	většinou

Pole osoby

Každý záznam v current a past má stejná pole. Bez režimu v reálném čase má osoba stejné entity_id ve všech profilech firem i v profilu osoby. Díky tomu ji poznáš napříč firmami. Osoby z dotazu v reálném čase mají vlastní ID.

Pole
Pole	Význam	Příklad	Dostupnost
related_persons.current[].entity_idstring\|null	ID osoby. Bez režimu v reálném čase je stejné ve všech profilech firem a odpovídá entity_id v profilu osoby.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	vždy
related_persons.current[].labelstring	Role jako pevná hodnota. Jiné hodnoty jsou možné.Hodnoty: `MANAGING_DIRECTOR` jednatel (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` nouzový jednatel (Notgeschäftsführer), `BOARD` člen představenstva (Vorstand), `BOARD_CHAIR` předseda představenstva, `DIRECTOR` výkonný ředitel, například u SE, `PROCURA` prokurista (Prokurist), `LIQUIDATOR` likvidátor, `INSOLVENCY_ADMINISTRATOR` insolvenční správce, `REPRESENTATIVE` stálý zástupce, `FULLY_LIABLE_PARTNER` komplementář (persönlich haftender Gesellschafter), `LIMITED_PARTNER` komanditista (Kommanditist), `PARTNER` partner, `OWNER` majitel (Inhaber), `PROPRIETOR` majitel (Inhaber), `TREASURER` pokladník spolku, `SECRETARY` jednatel spolku (zapisovatel), `YOUTH_WARDEN` vedoucí mládeže spolku, `WATER_WARDEN` správce vod spolku, `OTHER` jiná role	`"MANAGING_DIRECTOR"`	jako výše
related_persons.current[].roleobject	Název role k zobrazení, v de a en, vždy dlouhý (long) a krátký (short), například Geschäftsführer a GF.	–	jako výše
related_persons.current[].namestring	Celé jméno tak, jak je uvedeno v rejstříku.	`"Paul Musterwald"`	jako výše
related_persons.current[].name_partsobject	Jméno rozdělené na části, pro řazení a přiřazování.	–	jako výše
related_persons.current[].name_parts.givenstring\|null	Křestní jméno, při více jménech všechna.	`"Paul"`	jako výše
related_persons.current[].name_parts.familystring\|null	Příjmení.	`"Musterwald"`	jako výše
related_persons.current[].name_parts.canonical_namestring\|null	Jméno, obvykle ve tvaru „Příjmení, Křestní jméno“, pro řazení a přiřazování.	`"Musterwald, Paul"`	jako výše
related_persons.current[].name_parts.maidenstring\|null	Rodné příjmení.Prázdné, když žádné není zapsáno	`null`	zřídka
related_persons.current[].name_parts.previous_namesarray\|null	Dřívější jména osoby jako seznam.Prázdné, když žádná nejsou zapsána	`null`	jako výše
related_persons.current[].titlesarray	Akademické tituly, například Dr. Klíč chybí, pokud není zapsán žádný titul.	–	jako výše
related_persons.current[].birth_datestring\|null	Datum narození ve formátu YYYY-MM-DD, jak je zapsáno.Prázdné, když není zapsáno žádné datum	`"1989-07-18"`	většinou
related_persons.current[].locationobject\|null	Místa osoby.	–	jako výše
related_persons.current[].location.home.citystring\|null	Bydliště, jak je zapsáno. Rejstřík neobsahuje úplnou adresu.Prázdné, když není zapsáno žádné bydliště	`"Exempelingen i. Bay."`	jako výše
related_persons.current[].start_datestring\|null	Začátek role ve formátu YYYY-MM-DD.Prázdné, když začátek není známý, například v režimu v reálném čase	`"2019-01-04"`	jako výše
related_persons.current[].end_datestring\|null	Konec role. Je vyplněn u osob v past.Prázdné, když role stále trvá	`null`	vždy

Jednatelé a představenstvo

Jednatelé (Geschäftsführer) GmbH nebo UG mají label MANAGING_DIRECTOR. Představenstvo (Vorstand) AG, SE nebo eG poznáš podle BOARD, jeho předsedu podle BOARD_CHAIR. Při zrušení firmy přebírají zastupování likvidátoři s LIQUIDATOR.

Role vždy kontroluj podle label. Texty v role jsou určeny k zobrazení.

Prokura

Prokura je plná moc zapsaná v rejstříku k zastupování firmy téměř ve všech obchodech. Prokuristé (Prokuristen) mají label PROCURA. Zda smí někdo jednat sám, nebo jen společně s dalšími, je v role_representation_scheme, například „Gesamtprokura gemeinsam mit einem Vorstandsmitglied“ (společná prokura spolu se členem představenstva).

Komplementáři

V KG, OHG a KGaA zastupují firmu osobně ručící společníci (persönlich haftende Gesellschafter). Mají label FULLY_LIABLE_PARTNER. Komanditisté (Kommanditisten) KG jsou v rejstříku s LIMITED_PARTNER, majitel e.K. s OWNER, partneři PartG nebo eGbR s PARTNER.

V GmbH & Co. KG je komplementářem obvykle sama GmbH. Její jednatele najdeš v profilu firmy této GmbH.

Role podle právní formy

Jaké role firma má, vyplývá z její právní formy. Tabulka ukazuje, které labely typicky uvidíš u které právní formy. Všechny labely s jejich významem jsou uvedeny výše u label.

Právní forma
Právní forma	Typické labely
GmbH, UG	MANAGING_DIRECTOR, PROCURA, v likvidaci LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, u KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Oprávnění k zastupování

Každá osoba přichází se dvěma sadami pravidel. role_representation_scheme je její vlastní oprávnění, například „einzelvertretungsberechtigt“ (oprávněn zastupovat samostatně). organization_representation_scheme je obecné pravidlo firmy, stejné jako representation_scheme v základních údajích. Obě mají current a history; u bývalých osob nahrazuje current pole latest.

Pole
Pole	Význam	Příklad	Dostupnost
related_persons.current[].role_representation_schemeobject	Vlastní oprávnění osoby k zastupování, například „einzelvertretungsberechtigt“ (oprávněn zastupovat samostatně) nebo osvobození od § 181 BGB. current je platné znění, history změny s value, effective_from a effective_to.`related_persons`	–	většinou: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG zřídka: e.K.
related_persons.current[].organization_representation_schemeobject	Obecný způsob zastupování firmy, přiložený ke každé osobě. Strukturovaný jako role_representation_scheme.	–	vždy: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG většinou: AG, SE, KGaA, e.K.

Osoby v režimu v reálném čase

S realtime_mode=handelsregister-default přicházejí aktuálně zapsané osoby přímo z Handelsregister, i bez funkce related_persons. Účtuje se pak jen režim v reálném čase, ne funkce. Odpověď obsahuje jen current.

V tomto seznamu jsou start_date a end_date prázdné, jména mohou být kratší a entity_id osoby se může lišit od toho bez režimu v reálném čase. Osoby přiřazuj podle jména a data narození.

Pokud si vyžádáš režim v reálném čase a related_persons společně, current pochází z živého dotazu a past z profilu firmy. Pak se účtuje i funkce.

Pole
Pole	Význam	Příklad	Dostupnost
related_persons.current[].name_parts.aliasesarray	Varianty zápisu jména ze živého dotazu, ve tvaru „Příjmení, Křestní jméno“. Jen v režimu v reálném čase.`related_persons`	–	vždy

Profil osoby

Profil osoby (fetch-person) popisuje jednu osobu: její role ve všech firmách, se kterými je propojená, a co o ní říkají veřejné webové zdroje. Osobu najdeš podle jejího jména a firmy, ve které má nebo měla roli.

Profil osoby je součástí každého předplatného kreditů od tarifu Plus. Požadavek často trvá deset až třicet sekund, protože hledáme na webu. Nastav časový limit svého klienta alespoň na 120 sekund.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: TVUJ_API_KLIC" \
  --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": "TVUJ_API_KLIC"},
    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": "TVUJ_API_KLIC" },
});
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 · Ukázková odpověď: profil osoby Max Felix Mustermann (ukázková data) u Hetzner Online GmbH, zkráceno

Osoba

Jméno, datum narození a bydliště pocházejí z rejstříku. entity_id je stejné jako v related_persons profilů firem bez režimu v reálném čase.

Pole
Pole	Význam	Příklad	Dostupnost
entity_idstring	ID osoby. Stejné ID se objevuje v related_persons profilů firem bez režimu v reálném čase.Profil osoby	`"08ed5f967956831ca6588930fd2693ed"`	vždy
namestring	Celé jméno tak, jak je uvedeno v rejstříku.	`"Max Felix Mustermann"`	jako výše
birth_datestring\|null	Datum narození ve formátu YYYY-MM-DD, jak je zapsáno.Prázdné, když není zapsáno žádné datum	`"1976-01-15"`	většinou
name_partsobject	Jméno rozdělené na části, strukturované jako v related_persons.	–	vždy
name_parts.givenstring\|null	Křestní jméno, při více jménech všechna.	`"Max Felix"`	jako výše
name_parts.familystring\|null	Příjmení.	`"Mustermann"`	jako výše
name_parts.canonical_namestring\|null	Jméno, obvykle ve tvaru „Příjmení, Křestní jméno“, pro řazení a přiřazování.	`"Mustermann, Max Felix"`	jako výše
name_parts.maidenstring\|null	Rodné příjmení.Prázdné, když žádné není zapsáno	`null`	zřídka
name_parts.previous_namesarray\|null	Dřívější jména osoby jako seznam.Prázdné, když žádná nejsou zapsána	`null`	jako výše
locationobject	Místa osoby.	–	většinou
location.home.citystring\|null	Bydliště, jak je zapsáno.Prázdné, když není zapsáno žádné bydliště	`"Musterheim"`	jako výše

Role a vazby

handelsregister_roles uvádí každou zapsanou roli osoby s firmou a obdobím. Pomocí entity_id firmy načteš její profil firmy. affiliations stručně shrnuje vazby, z rejstříku a z webu.

Pole
Pole	Význam	Příklad	Dostupnost
handelsregister_rolesarray	Zapsané role osoby s firmou a obdobím, současné i bývalé.Profil osoby	–	vždy
handelsregister_roles[].entity_idstring	entity_id firmy, pro profil firmy v parametru q.	`"0b3435f83ce8591300625100815d4583"`	jako výše
handelsregister_roles[].namestring	Název firmy.	`"Hetzner Online GmbH"`	jako výše
handelsregister_roles[].labelstring	Role jako pevná hodnota, stejné hodnoty jako label v related_persons, například MANAGING_DIRECTOR, BOARD, PROCURA nebo LIMITED_PARTNER.	`"BOARD"`	jako výše
handelsregister_roles[].roleobject	Název role k zobrazení, jako text v de a en.	–	jako výše
handelsregister_roles[].start_datestring\|null	Začátek role ve formátu YYYY-MM-DD.Prázdné, když začátek není známý	`"2002-10-15"`	většinou
handelsregister_roles[].end_datestring\|null	Konec role.Prázdné, když role stále trvá	`"2015-07-28"`	vždy
affiliationsarray	Firmy, se kterými je osoba propojená, každá s druhem vazby. Shrnuto z rejstříku a webových zdrojů.	–	jako výše
affiliations[].organizationstring	Název firmy.	`"ENSoXX Holding AG"`	jako výše
affiliations[].relationstring	Druh vazby jako německý text, například Geschäftsführer (jednatel), Prokura nebo Kommanditist (komanditista).	`"Vorstandsmitglied"`	jako výše

Rešerše na webu

Krátký životopis, oblasti odbornosti, kontaktní kanály a zdroje sbíráme z veřejných webových zdrojů. Kolik toho existuje, závisí na tom, jak viditelná je osoba na webu.

Pole
Pole	Význam	Příklad	Dostupnost
biostring\|null	Krátký životopis osoby v jedné nebo dvou větách, německy.Prázdné, když je o osobě na webu příliš málo (pak null)Profil osoby	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	většinou
expertisearray	Oblasti odbornosti a témata osoby jako seznam.Prázdné, když je o osobě na webu příliš málo	–	jako výše
contactobject	Veřejně uvedené kontaktní kanály, s emails a phones.	–	vždy
contact.emailsarray	E-mailové adresy jako seznam.Prázdné, když nebyla nalezena žádná adresa	–	zřídka
contact.emails[].addressstring	E-mailová adresa.	`"[email protected]"`	jako výše
contact.emails[].typestring	Druh adresy. organization znamená: adresa firmy, ne soukromá.	`"organization"`	jako výše
contact.emails[].labelstring	K čemu adresa slouží, jako krátký text.	`"Allgemeine Unternehmenskontakt-E-Mail"`	jako výše
contact.phonesarray	Telefonní čísla jako seznam.Prázdné, když nebylo nalezeno žádné číslo	–	jako výše
contact.phones[].numberstring	Číslo, obvykle v mezinárodním formátu.	`"+49374574447100"`	jako výše
contact.phones[].typestring	Druh čísla. organization znamená: číslo firmy.	`"organization"`	jako výše
contact.phones[].entitystring	Firma, ke které číslo patří.	`"Hetzner Online GmbH"`	jako výše
contact.phones[].labelstring	K čemu číslo slouží, například ústředna nebo fax.	`"Öffentliche Unternehmens-Telefonnummer"`	jako výše
profilesobject	Webové stránky o osobě, s linkedin a other.	–	vždy
profiles.linkedinstring\|null	Adresa profilu na LinkedIn.Prázdné, když žádný nebyl nalezen	`null`	zřídka
profiles.otherarray	Další stránky o osobě, například tiskové články nebo týmové stránky, jako seznam adres.Prázdné, když žádné nebyly nalezeny	–	většinou

Tyto informace sestavuje AI z veřejných zdrojů. Používáme k tomu nejnovější technologie a hodně investujeme do kvality; jednotlivé chyby přesto nelze vyloučit.

Účasti a síť

Profil osoby rozšiřují dvě funkce: shareholdings ukazuje firmy, ve kterých má osoba podíly. network ukazuje firmy a osoby, se kterými je propojená, přes dvě úrovně. Obě se účtují jen tehdy, když vrátí data.

Pole
Pole	Význam	Příklad	Dostupnost
shareholdingsobject\|null	Firmy, ve kterých má osoba dnes podíly.Prázdné, když není známa žádná účast`shareholdings`	–	částečně
shareholdings.holdings.currentarray	Současné účasti jako seznam.	–	jako výše
shareholdings.holdings.current[].organizationobject	Firma s entity_id, name, status, legal_form, address a registration, strukturovaná jako v základních údajích.	–	jako výše
shareholdings.holdings.current[].ownership.percentagenumber\|null	Podíl na kapitálu v procentech, například 33.33.	`100`	jako výše
shareholdings.holdings.current[].ownership.contributionobject\|null	Jmenovitá hodnota účasti s amount a currency.	–	jako výše
shareholdings.holdings.current[].as_ofstring\|null	Datum údaje ve formátu YYYY-MM-DD.	`"2025-01-13"`	jako výše
shareholdings.summary.total_currentinteger	Počet současných účastí.	`3`	jako výše
networkobject\|null	Firmy a osoby, se kterými je osoba propojená, přes dvě úrovně. Strukturováno jako network v profilu firmy.`network` · od Pro · Beta	–	většinou
network.depthinteger	Kolik úrovní síť pokrývá, počítáno od osoby. Osoba sama je úroveň 0.	`2`	jako výše
network.nodesarray	Uzly: osoby (PERSON) a firmy (ORGANIZATION) s entity_id, jménem a úrovní. Osoba sama má is_root true.	–	jako výše
network.connectionsarray	Vazby mezi dvěma uzly, každá s kind (ROLE, OWNERSHIP nebo GROUP), label, obdobím a is_current.	–	jako výše

Dále

fetch-organization Endpoint s funkcí related_persons a režimem v reálném čase. fetch-person Načíst profil osoby: parametry, náklady a chyby. Najít jednatele a společníky Krok za krokem od firmy k jejím osobám. Společníci a účasti Komu firma patří a v čem má podíly.