Osoby i reprezentacja – Dokumentacja

Pobierz osoby

Zamów feature related_persons. Odpowiedź zawiera wtedy klucz related_persons z dwiema listami: current dla wszystkich, którzy pełnią swoją rolę dziś, i past dla wszystkich, którzy odeszli. Każda rola to osobny wpis. W naszym przykładowym zapytaniu o Hetzner Online GmbH, Ansbach HRB 6089, current zawierało trzech członków zarządu. Dwóch z nich pojawiło się ponownie w past z dawną prokurą. Wszystkie dane osobowe w przykładowych odpowiedziach są przykładowe.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TWOJ_KLUCZ_API" \
  --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": "TWOJ_KLUCZ_API"},
    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": "TWOJ_KLUCZ_API" },
});
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 · Przykładowa odpowiedź: Hetzner Online GmbH z feature related_persons, skrócona do nazwy i osób

Pole
Pole	Znaczenie	Przykład	Dostępność
related_personsobject\|null	Wszystkie wpisane osoby firmy, podzielone na current i past.`related_persons`	–	zawsze
related_persons.currentarray	Osoby, które pełnią swoją rolę dziś.	–	jak wyżej
related_persons.pastarray	Osoby, które odeszły, z tymi samymi polami co current. W obu zasadach reprezentacji latest zastępuje current: ostatnia wersja przed odejściem.Puste, gdy od wpisu nikt nie odszedł	–	zwykle

Pola osoby

Każdy wpis w current i past ma te same pola. Bez trybu czasu rzeczywistego osoba ma to samo entity_id we wszystkich profilach firm i w profilu osoby. Dzięki temu rozpoznasz ją w różnych firmach. Osoby z zapytania w trybie czasu rzeczywistego mają własne identyfikatory.

Pole
Pole	Znaczenie	Przykład	Dostępność
related_persons.current[].entity_idstring\|null	Identyfikator osoby. Bez trybu czasu rzeczywistego jest taki sam we wszystkich profilach firm i zgadza się z entity_id w profilu osoby.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	zawsze
related_persons.current[].labelstring	Rola jako stała wartość. Możliwe są inne wartości.Wartości: `MANAGING_DIRECTOR` członek zarządu GmbH (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` członek zarządu ustanowiony przez sąd (Notgeschäftsführer), `BOARD` członek zarządu (Vorstand), `BOARD_CHAIR` przewodniczący zarządu, `DIRECTOR` dyrektor wykonawczy, np. SE, `PROCURA` prokurent (Prokurist), `LIQUIDATOR` likwidator, `INSOLVENCY_ADMINISTRATOR` syndyk, `REPRESENTATIVE` stały przedstawiciel, `FULLY_LIABLE_PARTNER` wspólnik osobiście odpowiedzialny (persönlich haftender Gesellschafter), `LIMITED_PARTNER` komandytariusz (Kommanditist), `PARTNER` partner, `OWNER` właściciel (Inhaber), `PROPRIETOR` właściciel (Inhaber), `TREASURER` skarbnik stowarzyszenia, `SECRETARY` sekretarz stowarzyszenia, `YOUTH_WARDEN` opiekun młodzieży w stowarzyszeniu, `WATER_WARDEN` opiekun wód w stowarzyszeniu, `OTHER` inna rola	`"MANAGING_DIRECTOR"`	jak wyżej
related_persons.current[].roleobject	Nazwa roli do wyświetlania, w de i en, każda w wersji długiej (long) i krótkiej (short), np. Geschäftsführer i GF.	–	jak wyżej
related_persons.current[].namestring	Pełne imię i nazwisko, tak jak w rejestrze.	`"Paul Musterwald"`	jak wyżej
related_persons.current[].name_partsobject	Imię i nazwisko rozbite na części, do sortowania i dopasowywania.	–	jak wyżej
related_persons.current[].name_parts.givenstring\|null	Imię, wszystkie, jeśli jest ich kilka.	`"Paul"`	jak wyżej
related_persons.current[].name_parts.familystring\|null	Nazwisko.	`"Musterwald"`	jak wyżej
related_persons.current[].name_parts.canonical_namestring\|null	Imię i nazwisko, zwykle w formie „Nazwisko, Imię”, do sortowania i dopasowywania.	`"Musterwald, Paul"`	jak wyżej
related_persons.current[].name_parts.maidenstring\|null	Nazwisko rodowe.Puste, gdy nie wpisano go	`null`	rzadko
related_persons.current[].name_parts.previous_namesarray\|null	Wcześniejsze nazwiska osoby jako lista.Puste, gdy nie wpisano żadnych	`null`	jak wyżej
related_persons.current[].titlesarray	Tytuły naukowe, np. Dr. Klucza brakuje, jeśli nie wpisano tytułu.	–	jak wyżej
related_persons.current[].birth_datestring\|null	Data urodzenia w formacie YYYY-MM-DD, tak jak wpisana.Puste, gdy nie wpisano daty	`"1989-07-18"`	zwykle
related_persons.current[].locationobject\|null	Miejsca związane z osobą.	–	jak wyżej
related_persons.current[].location.home.citystring\|null	Miejsce zamieszkania, tak jak wpisane. Rejestr nie zawiera pełnego adresu.Puste, gdy nie wpisano miejsca zamieszkania	`"Exempelingen i. Bay."`	jak wyżej
related_persons.current[].start_datestring\|null	Początek roli w formacie YYYY-MM-DD.Puste, gdy początek nie jest znany, np. w trybie czasu rzeczywistego	`"2019-01-04"`	jak wyżej
related_persons.current[].end_datestring\|null	Koniec roli. Jest ustawiony dla osób w past.Puste, gdy rola nadal trwa	`null`	zawsze

Członkowie zarządu (Geschäftsführung i Vorstand)

Członkowie zarządu (Geschäftsführer) GmbH lub UG mają label MANAGING_DIRECTOR. Zarząd (Vorstand) AG, SE lub eG rozpoznasz po BOARD, jego przewodniczącego po BOARD_CHAIR. Gdy firma zostaje rozwiązana, reprezentację przejmują likwidatorzy z LIQUIDATOR.

Role zawsze sprawdzaj po label. Teksty w role służą do wyświetlania.

Prokura

Prokura (prokura) to wpisane do rejestru pełnomocnictwo do reprezentowania firmy w niemal wszystkich sprawach. Prokurenci (Prokuristen) mają label PROCURA. Czy ktoś może działać samodzielnie, czy tylko razem z innymi, stoi w role_representation_scheme, np. „Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (prokura łączna wraz z członkiem zarządu).

Wspólnicy osobiście odpowiedzialni

W KG, OHG i KGaA firmę reprezentują wspólnicy osobiście odpowiedzialni (persönlich haftende Gesellschafter). Mają label FULLY_LIABLE_PARTNER. Komandytariusze (Kommanditisten) KG są w rejestrze z LIMITED_PARTNER, właściciel e.K. z OWNER, partnerzy PartG lub eGbR z PARTNER.

W GmbH & Co. KG komplementariuszem jest zwykle sama GmbH. Jej członków zarządu znajdziesz w profilu firmy tej GmbH.

Role według formy prawnej

Jakie role ma firma, wynika z jej formy prawnej. Tabela pokazuje, jakie labele zwykle widzisz dla danej formy prawnej. Wszystkie labele ze znaczeniem są wymienione wyżej pod label.

Forma prawna
Forma prawna	Typowe labele
GmbH, UG	MANAGING_DIRECTOR, PROCURA, w likwidacji LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, przy KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Prawo reprezentacji

Każda osoba ma dwa zestawy zasad. role_representation_scheme to jej własne umocowanie, np. „einzelvertretungsberechtigt” (może reprezentować samodzielnie). organization_representation_scheme to ogólna zasada firmy, ta sama co representation_scheme w danych podstawowych. Oba mają current i history; u byłych osób latest zastępuje current.

Pole
Pole	Znaczenie	Przykład	Dostępność
related_persons.current[].role_representation_schemeobject	Własne prawo reprezentacji osoby, np. „einzelvertretungsberechtigt” (może reprezentować samodzielnie) lub zwolnienie z § 181 BGB. current to obowiązująca wersja, history zmiany z value, effective_from i effective_to.`related_persons`	–	zwykle: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG rzadko: e.K.
related_persons.current[].organization_representation_schemeobject	Ogólne zasady reprezentacji firmy, dołączone do każdej osoby. Struktura jak role_representation_scheme.	–	zawsze: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG zwykle: AG, SE, KGaA, e.K.

Osoby w trybie czasu rzeczywistego

Z realtime_mode=handelsregister-default aktualnie wpisane osoby pochodzą wprost z Handelsregister (rejestr handlowy), nawet bez feature related_persons. Naliczany jest wtedy tylko tryb czasu rzeczywistego, nie feature. Odpowiedź zawiera tylko current.

Na tej liście start_date i end_date są puste, nazwiska mogą być krótsze, a entity_id osoby może się różnić od tego bez trybu czasu rzeczywistego. Dopasowuj osoby po imieniu, nazwisku i dacie urodzenia.

Jeśli zamówisz tryb czasu rzeczywistego i related_persons razem, current pochodzi z zapytania na żywo, a past z profilu firmy. Wtedy naliczany jest też feature.

Pole
Pole	Znaczenie	Przykład	Dostępność
related_persons.current[].name_parts.aliasesarray	Warianty zapisu imienia i nazwiska z zapytania na żywo, w formie „Nazwisko, Imię”. Tylko w trybie czasu rzeczywistego.`related_persons`	–	zawsze

Profil osoby

Profil osoby (fetch-person) opisuje jedną osobę: jej role we wszystkich firmach, z którymi jest powiązana, oraz to, co mówią o niej publiczne źródła w sieci. Osobę znajdujesz po imieniu i nazwisku oraz firmie, w której pełni lub pełniła jakąś rolę.

Profil osoby jest dostępny w każdej subskrypcji kredytów od Plus. Zapytanie trwa często od dziesięciu do trzydziestu sekund, bo przeszukujemy sieć. Ustaw timeout klienta na co najmniej 120 sekund.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: TWOJ_KLUCZ_API" \
  --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": "TWOJ_KLUCZ_API"},
    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": "TWOJ_KLUCZ_API" },
});
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 · Przykładowa odpowiedź: profil osoby Max Felix Mustermann (dane przykładowe) w Hetzner Online GmbH, skrócony

Osoba

Imię i nazwisko, data urodzenia i miejsce zamieszkania pochodzą z rejestru. entity_id jest takie samo jak w related_persons profili firm bez trybu czasu rzeczywistego.

Pole
Pole	Znaczenie	Przykład	Dostępność
entity_idstring	Identyfikator osoby. Ten sam identyfikator występuje w related_persons profili firm bez trybu czasu rzeczywistego.Profil osoby	`"08ed5f967956831ca6588930fd2693ed"`	zawsze
namestring	Pełne imię i nazwisko, tak jak w rejestrze.	`"Max Felix Mustermann"`	jak wyżej
birth_datestring\|null	Data urodzenia w formacie YYYY-MM-DD, tak jak wpisana.Puste, gdy nie wpisano daty	`"1976-01-15"`	zwykle
name_partsobject	Imię i nazwisko rozbite na części, w tej samej strukturze co w related_persons.	–	zawsze
name_parts.givenstring\|null	Imię, wszystkie, jeśli jest ich kilka.	`"Max Felix"`	jak wyżej
name_parts.familystring\|null	Nazwisko.	`"Mustermann"`	jak wyżej
name_parts.canonical_namestring\|null	Imię i nazwisko, zwykle w formie „Nazwisko, Imię”, do sortowania i dopasowywania.	`"Mustermann, Max Felix"`	jak wyżej
name_parts.maidenstring\|null	Nazwisko rodowe.Puste, gdy nie wpisano go	`null`	rzadko
name_parts.previous_namesarray\|null	Wcześniejsze nazwiska osoby jako lista.Puste, gdy nie wpisano żadnych	`null`	jak wyżej
locationobject	Miejsca związane z osobą.	–	zwykle
location.home.citystring\|null	Miejsce zamieszkania, tak jak wpisane.Puste, gdy nie wpisano miejsca zamieszkania	`"Musterheim"`	jak wyżej

Role i powiązania

handelsregister_roles wymienia każdą wpisaną rolę osoby z firmą i okresem. Przez entity_id firmy pobierzesz jej profil firmy. affiliations krótko podsumowuje powiązania, z rejestru i sieci.

Pole
Pole	Znaczenie	Przykład	Dostępność
handelsregister_rolesarray	Wpisane role osoby z firmą i okresem, obecne i byłe.Profil osoby	–	zawsze
handelsregister_roles[].entity_idstring	entity_id firmy, do profilu firmy w parametrze q.	`"0b3435f83ce8591300625100815d4583"`	jak wyżej
handelsregister_roles[].namestring	Nazwa firmy.	`"Hetzner Online GmbH"`	jak wyżej
handelsregister_roles[].labelstring	Rola jako stała wartość, te same wartości co label w related_persons, np. MANAGING_DIRECTOR, BOARD, PROCURA lub LIMITED_PARTNER.	`"BOARD"`	jak wyżej
handelsregister_roles[].roleobject	Nazwa roli do wyświetlania, jako tekst w de i en.	–	jak wyżej
handelsregister_roles[].start_datestring\|null	Początek roli w formacie YYYY-MM-DD.Puste, gdy początek nie jest znany	`"2002-10-15"`	zwykle
handelsregister_roles[].end_datestring\|null	Koniec roli.Puste, gdy rola nadal trwa	`"2015-07-28"`	zawsze
affiliationsarray	Firmy, z którymi osoba jest powiązana, każda z rodzajem powiązania. Podsumowane ze źródeł rejestrowych i z sieci.	–	jak wyżej
affiliations[].organizationstring	Nazwa firmy.	`"ENSoXX Holding AG"`	jak wyżej
affiliations[].relationstring	Rodzaj powiązania jako tekst po niemiecku, np. Geschäftsführer (członek zarządu), Prokura lub Kommanditist (komandytariusz).	`"Vorstandsmitglied"`	jak wyżej

Wyszukiwanie w sieci

Krótki biogram, obszary specjalizacji, kanały kontaktu i źródła zbieramy z publicznych źródeł w sieci. Ile z tego istnieje, zależy od tego, jak widoczna jest osoba w sieci.

Pole
Pole	Znaczenie	Przykład	Dostępność
biostring\|null	Krótki biogram osoby w jednym lub dwóch zdaniach, po niemiecku.Puste, gdy w sieci jest o osobie za mało (wtedy null)Profil osoby	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	zwykle
expertisearray	Obszary specjalizacji i tematy osoby jako lista.Puste, gdy w sieci jest o osobie za mało	–	jak wyżej
contactobject	Publicznie podane kanały kontaktu, z e-mailami i telefonami.	–	zawsze
contact.emailsarray	Adresy e-mail jako lista.Puste, gdy nie znaleziono adresu	–	rzadko
contact.emails[].addressstring	Adres e-mail.	`"[email protected]"`	jak wyżej
contact.emails[].typestring	Rodzaj adresu. organization oznacza: adres firmy, nie prywatny.	`"organization"`	jak wyżej
contact.emails[].labelstring	Do czego służy adres, jako krótki tekst.	`"Allgemeine Unternehmenskontakt-E-Mail"`	jak wyżej
contact.phonesarray	Numery telefonów jako lista.Puste, gdy nie znaleziono numeru	–	jak wyżej
contact.phones[].numberstring	Numer, zwykle w formacie międzynarodowym.	`"+49374574447100"`	jak wyżej
contact.phones[].typestring	Rodzaj numeru. organization oznacza: numer firmy.	`"organization"`	jak wyżej
contact.phones[].entitystring	Firma, do której należy numer.	`"Hetzner Online GmbH"`	jak wyżej
contact.phones[].labelstring	Do czego służy numer, np. centrala lub faks.	`"Öffentliche Unternehmens-Telefonnummer"`	jak wyżej
profilesobject	Strony internetowe o osobie, z linkedin i other.	–	zawsze
profiles.linkedinstring\|null	Adres profilu na LinkedIn.Puste, gdy nie znaleziono go	`null`	rzadko
profiles.otherarray	Inne strony o osobie, np. artykuły prasowe lub strony zespołu, jako lista adresów.Puste, gdy nie znaleziono żadnych	–	zwykle

Te informacje zestawia AI z publicznych źródeł. Używamy do tego najnowszej technologii i dużo inwestujemy w jakość; pojedyncze błędy są jednak możliwe.

Udziały i sieć powiązań

Dwa features rozszerzają profil osoby: shareholdings pokazuje firmy, w których osoba ma udziały. network pokazuje firmy i osoby, z którymi jest powiązana, na dwóch poziomach. Oba są naliczane tylko wtedy, gdy zwracają dane.

Pole
Pole	Znaczenie	Przykład	Dostępność
shareholdingsobject\|null	Firmy, w których osoba ma dziś udziały.Puste, gdy nie jest znany żaden udział`shareholdings`	–	częściowo
shareholdings.holdings.currentarray	Obecne udziały jako lista.	–	jak wyżej
shareholdings.holdings.current[].organizationobject	Firma z entity_id, name, status, legal_form, address i registration, w tej samej strukturze co w danych podstawowych.	–	jak wyżej
shareholdings.holdings.current[].ownership.percentagenumber\|null	Udział w kapitale w procentach, np. 33.33.	`100`	jak wyżej
shareholdings.holdings.current[].ownership.contributionobject\|null	Wartość nominalna udziału z kwotą i walutą.	–	jak wyżej
shareholdings.holdings.current[].as_ofstring\|null	Data informacji w formacie YYYY-MM-DD.	`"2025-01-13"`	jak wyżej
shareholdings.summary.total_currentinteger	Liczba obecnych udziałów.	`3`	jak wyżej
networkobject\|null	Firmy i osoby, z którymi osoba jest powiązana, na dwóch poziomach. Struktura jak network w profilu firmy.`network` · od Pro · Beta	–	zwykle
network.depthinteger	Ile poziomów obejmuje sieć, licząc od osoby. Sama osoba to poziom 0.	`2`	jak wyżej
network.nodesarray	Węzły: osoby (PERSON) i firmy (ORGANIZATION) z entity_id, nazwą i poziomem. Sama osoba ma is_root true.	–	jak wyżej
network.connectionsarray	Powiązania między dwoma węzłami, każde z kind (ROLE, OWNERSHIP lub GROUP), label, okresem i is_current.	–	jak wyżej

Dalej

fetch-organization Endpoint z feature related_persons i trybem czasu rzeczywistego. fetch-person Pobieranie profilu osoby: parametry, koszty i błędy. Znajdź członków zarządu i wspólników Krok po kroku od firmy do jej osób. Wspólnicy i udziały Do kogo należy firma i w czym ma udziały.