Persoane și reprezentare – Documentație

Preia persoanele

Cere funcția related_persons. Răspunsul conține atunci cheia related_persons cu două liste: current pentru toți cei care își au rolul azi și past pentru toți cei care au plecat. Fiecare rol este o intrare separată. În cererea noastră exemplu pentru Hetzner Online GmbH, Ansbach HRB 6089, current conținea trei administratori. Doi dintre ei apăreau din nou în past cu Prokura lor anterioară. Toate datele personale din răspunsurile exemplu sunt date de exemplu.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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 · Răspuns exemplu: Hetzner Online GmbH cu funcția related_persons, scurtat la denumire și persoane

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
related_personsobject\|null	Toate persoanele înscrise ale companiei, împărțite în current și past.`related_persons`	–	întotdeauna
related_persons.currentarray	Persoanele care își au rolul azi.	–	ca mai sus
related_persons.pastarray	Persoanele care au plecat, cu aceleași câmpuri ca current. La cele două reguli de reprezentare, latest înlocuiește current: ultima versiune înainte de plecare.Gol când nimeni nu a plecat de la înscriere	–	de obicei

Câmpurile unei persoane

Fiecare intrare din current și past are aceleași câmpuri. Fără Timp real, o persoană are același entity_id în toate profilurile de companie și în profilul de persoană. Așa o recunoști între companii. Persoanele dintr-o interogare în Timp real au propriile ID-uri.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
related_persons.current[].entity_idstring\|null	ID-ul persoanei. Fără Timp real, este același în toate profilurile de companie și corespunde entity_id-ului din profilul de persoană.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	întotdeauna
related_persons.current[].labelstring	Rolul ca valoare fixă. Sunt posibile și alte valori.Valori: `MANAGING_DIRECTOR` administrator (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` administrator provizoriu numit de instanță (Notgeschäftsführer), `BOARD` membru al consiliului de administrație (Vorstand), `BOARD_CHAIR` președinte al consiliului de administrație, `DIRECTOR` director executiv, de exemplu al unui SE, `PROCURA` titular de Prokura (Prokurist), `LIQUIDATOR` lichidator, `INSOLVENCY_ADMINISTRATOR` administrator judiciar în insolvență, `REPRESENTATIVE` reprezentant permanent, `FULLY_LIABLE_PARTNER` asociat cu răspundere nelimitată (persönlich haftender Gesellschafter), `LIMITED_PARTNER` comanditar (Kommanditist), `PARTNER` partener, `OWNER` proprietar (Inhaber), `PROPRIETOR` proprietar (Inhaber), `TREASURER` trezorier al unei asociații, `SECRETARY` secretar al unei asociații, `YOUTH_WARDEN` responsabil de tineret al unei asociații, `WATER_WARDEN` responsabil de ape al unei asociații, `OTHER` alt rol	`"MANAGING_DIRECTOR"`	ca mai sus
related_persons.current[].roleobject	Denumirea rolului pentru afișare, în de și en, fiecare lungă (long) și scurtă (short), de exemplu Geschäftsführer și GF.	–	ca mai sus
related_persons.current[].namestring	Numele complet așa cum apare în registru.	`"Paul Musterwald"`	ca mai sus
related_persons.current[].name_partsobject	Numele împărțit în părți, pentru sortare și potrivire.	–	ca mai sus
related_persons.current[].name_parts.givenstring\|null	Prenumele, toate dacă sunt mai multe.	`"Paul"`	ca mai sus
related_persons.current[].name_parts.familystring\|null	Numele de familie.	`"Musterwald"`	ca mai sus
related_persons.current[].name_parts.canonical_namestring\|null	Numele, de obicei în forma „Nume de familie, Prenume”, pentru sortare și potrivire.	`"Musterwald, Paul"`	ca mai sus
related_persons.current[].name_parts.maidenstring\|null	Numele de naștere.Gol când nu este înregistrat niciunul	`null`	rar
related_persons.current[].name_parts.previous_namesarray\|null	Numele anterioare ale persoanei ca listă.Gol când nu este înregistrat niciunul	`null`	ca mai sus
related_persons.current[].titlesarray	Titluri academice, de exemplu Dr. Cheia lipsește dacă nu este înregistrat niciun titlu.	–	ca mai sus
related_persons.current[].birth_datestring\|null	Data nașterii în formatul YYYY-MM-DD, așa cum e înregistrată.Gol când nu este înregistrată nicio dată	`"1989-07-18"`	de obicei
related_persons.current[].locationobject\|null	Locurile persoanei.	–	ca mai sus
related_persons.current[].location.home.citystring\|null	Domiciliul, așa cum e înregistrat. Registrul nu conține o adresă completă.Gol când nu este înregistrat niciun domiciliu	`"Exempelingen i. Bay."`	ca mai sus
related_persons.current[].start_datestring\|null	Începutul rolului în formatul YYYY-MM-DD.Gol când începutul nu este cunoscut, de exemplu cu Timp real	`"2019-01-04"`	ca mai sus
related_persons.current[].end_datestring\|null	Sfârșitul rolului. Este setat pentru persoanele din past.Gol când rolul există încă	`null`	întotdeauna

Administratori și conducere

Administratorii (Geschäftsführer) unui GmbH sau UG au eticheta MANAGING_DIRECTOR. Consiliul de administrație (Vorstand) al unui AG, SE sau eG îl recunoști după BOARD, președintele său după BOARD_CHAIR. Când o companie este dizolvată, lichidatorii cu LIQUIDATOR preiau reprezentarea.

Verifică rolurile întotdeauna după label. Textele din role sunt destinate afișării.

Prokura

Prokura este procura înscrisă în registru de a reprezenta compania în aproape toate afacerile. Titularii de Prokura (Prokuristen) au eticheta PROCURA. Dacă cineva poate acționa singur sau doar împreună cu alții se află în role_representation_scheme, de exemplu „Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (Prokura colectivă împreună cu un membru al consiliului de administrație).

Asociați cu răspundere nelimitată

La un KG, OHG și KGaA, asociații cu răspundere nelimitată (persönlich haftende Gesellschafter) reprezintă compania. Au eticheta FULLY_LIABLE_PARTNER. Comanditarii (Kommanditisten) unui KG sunt în registru cu LIMITED_PARTNER, proprietarul unui e.K. cu OWNER, partenerii unui PartG sau eGbR cu PARTNER.

La un GmbH & Co. KG, asociatul cu răspundere nelimitată este de obicei el însuși un GmbH. Administratorii acestuia îi găsești în profilul de companie al acelui GmbH.

Roluri după forma juridică

Ce roluri are o companie rezultă din forma ei juridică. Tabelul arată ce etichete vezi de obicei pe fiecare formă juridică. Toate etichetele cu semnificația lor sunt listate mai sus la label.

Formă juridică
Formă juridică	Etichete tipice
GmbH, UG	MANAGING_DIRECTOR, PROCURA, în lichidare LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, la KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Puterea de reprezentare

Fiecare persoană vine cu două seturi de reguli. role_representation_scheme este propria ei putere, de exemplu „einzelvertretungsberechtigt” (poate reprezenta singură). organization_representation_scheme este regula generală a companiei, aceeași ca representation_scheme din datele de bază. Ambele au current și history; pentru persoanele anterioare, latest înlocuiește current.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
related_persons.current[].role_representation_schemeobject	Propria putere de reprezentare a persoanei, de exemplu „einzelvertretungsberechtigt” (poate reprezenta singură) sau o scutire de § 181 BGB. current este versiunea în vigoare, history modificările cu value, effective_from și effective_to.`related_persons`	–	de obicei: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG rar: e.K.
related_persons.current[].organization_representation_schemeobject	Regulile generale de reprezentare ale companiei, incluse la fiecare persoană. Structurate ca role_representation_scheme.	–	întotdeauna: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG de obicei: AG, SE, KGaA, e.K.

Persoane cu Timp real

Cu realtime_mode=handelsregister-default, persoanele înscrise în prezent vin direct din Handelsregister, chiar și fără funcția related_persons. Se taxează atunci doar Timp real, nu funcția. Răspunsul conține doar current.

În această listă, start_date și end_date sunt goale, numele pot fi mai scurte, iar entity_id-ul unei persoane poate diferi de cel fără Timp real. Potrivește persoanele după nume și data nașterii.

Dacă ceri Timp real și related_persons împreună, current vine din interogarea live, iar past din profilul de companie. Atunci se taxează și funcția.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
related_persons.current[].name_parts.aliasesarray	Variante de scriere ale numelui din interogarea live, în forma „Nume de familie, Prenume”. Doar cu Timp real.`related_persons`	–	întotdeauna

Profil persoană

Profilul de persoană (fetch-person) descrie o singură persoană: rolurile ei în toate companiile cu care este legată și ce spun despre ea sursele web publice. Găsești persoana după nume și o companie în care are sau a avut un rol.

Profilul de persoană vine cu orice abonament de credite de la Plus. O cerere durează adesea zece până la treizeci de secunde, pentru că facem cercetare pe web. Setează timeoutul clientului la cel puțin 120 de secunde.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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 · Răspuns exemplu: profilul de persoană al lui Max Felix Mustermann (date de exemplu) la Hetzner Online GmbH, scurtat

Persoana

Numele, data nașterii și domiciliul provin din registru. entity_id este același ca în related_persons din profilurile de companie fără Timp real.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
entity_idstring	ID-ul persoanei. Același ID apare în related_persons din profilurile de companie fără Timp real.Profil persoană	`"08ed5f967956831ca6588930fd2693ed"`	întotdeauna
namestring	Numele complet așa cum apare în registru.	`"Max Felix Mustermann"`	ca mai sus
birth_datestring\|null	Data nașterii în formatul YYYY-MM-DD, așa cum e înregistrată.Gol când nu este înregistrată nicio dată	`"1976-01-15"`	de obicei
name_partsobject	Numele împărțit în părți, structurat ca în related_persons.	–	întotdeauna
name_parts.givenstring\|null	Prenumele, toate dacă sunt mai multe.	`"Max Felix"`	ca mai sus
name_parts.familystring\|null	Numele de familie.	`"Mustermann"`	ca mai sus
name_parts.canonical_namestring\|null	Numele, de obicei în forma „Nume de familie, Prenume”, pentru sortare și potrivire.	`"Mustermann, Max Felix"`	ca mai sus
name_parts.maidenstring\|null	Numele de naștere.Gol când nu este înregistrat niciunul	`null`	rar
name_parts.previous_namesarray\|null	Numele anterioare ale persoanei ca listă.Gol când nu este înregistrat niciunul	`null`	ca mai sus
locationobject	Locurile persoanei.	–	de obicei
location.home.citystring\|null	Domiciliul, așa cum e înregistrat.Gol când nu este înregistrat niciun domiciliu	`"Musterheim"`	ca mai sus

Roluri și legături

handelsregister_roles listează fiecare rol înscris al persoanei, cu compania și perioada. Folosește entity_id-ul unei companii ca să preiei profilul ei de companie. affiliations rezumă pe scurt legăturile, din registru și de pe web.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
handelsregister_rolesarray	Rolurile înscrise ale persoanei cu companie și perioadă, actuale și anterioare.Profil persoană	–	întotdeauna
handelsregister_roles[].entity_idstring	entity_id-ul companiei, pentru un profil de companie în parametrul q.	`"0b3435f83ce8591300625100815d4583"`	ca mai sus
handelsregister_roles[].namestring	Denumirea companiei.	`"Hetzner Online GmbH"`	ca mai sus
handelsregister_roles[].labelstring	Rolul ca valoare fixă, aceleași valori ca label în related_persons, de exemplu MANAGING_DIRECTOR, BOARD, PROCURA sau LIMITED_PARTNER.	`"BOARD"`	ca mai sus
handelsregister_roles[].roleobject	Denumirea rolului pentru afișare, ca text în de și en.	–	ca mai sus
handelsregister_roles[].start_datestring\|null	Începutul rolului în formatul YYYY-MM-DD.Gol când începutul nu este cunoscut	`"2002-10-15"`	de obicei
handelsregister_roles[].end_datestring\|null	Sfârșitul rolului.Gol când rolul există încă	`"2015-07-28"`	întotdeauna
affiliationsarray	Companiile cu care persoana este legată, fiecare cu tipul legăturii. Rezumate din registru și din surse web.	–	ca mai sus
affiliations[].organizationstring	Denumirea companiei.	`"ENSoXX Holding AG"`	ca mai sus
affiliations[].relationstring	Tipul legăturii ca text în germană, de exemplu Geschäftsführer (administrator), Prokura sau Kommanditist (comanditar).	`"Vorstandsmitglied"`	ca mai sus

Cercetare web

Scurta biografie, domeniile de expertiză, căile de contact și sursele le colectăm din surse web publice. Cât există depinde de cât de vizibilă este persoana pe web.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
biostring\|null	Scurtă biografie a persoanei în una sau două propoziții, în germană.Gol când pe web există prea puțin despre persoană (atunci null)Profil persoană	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	de obicei
expertisearray	Domeniile de expertiză și temele persoanei ca listă.Gol când pe web există prea puțin despre persoană	–	ca mai sus
contactobject	Căi de contact listate public, cu emails și phones.	–	întotdeauna
contact.emailsarray	Adresele de e-mail ca listă.Gol când nu s-a găsit nicio adresă	–	rar
contact.emails[].addressstring	Adresa de e-mail.	`"[email protected]"`	ca mai sus
contact.emails[].typestring	Tipul adresei. organization înseamnă: o adresă a companiei, nu una privată.	`"organization"`	ca mai sus
contact.emails[].labelstring	La ce servește adresa, ca text scurt.	`"Allgemeine Unternehmenskontakt-E-Mail"`	ca mai sus
contact.phonesarray	Numerele de telefon ca listă.Gol când nu s-a găsit niciun număr	–	ca mai sus
contact.phones[].numberstring	Numărul, de obicei în format internațional.	`"+49374574447100"`	ca mai sus
contact.phones[].typestring	Tipul numărului. organization înseamnă: un număr al companiei.	`"organization"`	ca mai sus
contact.phones[].entitystring	Compania căreia îi aparține numărul.	`"Hetzner Online GmbH"`	ca mai sus
contact.phones[].labelstring	La ce servește numărul, de exemplu centrală sau fax.	`"Öffentliche Unternehmens-Telefonnummer"`	ca mai sus
profilesobject	Pagini web despre persoană, cu linkedin și other.	–	întotdeauna
profiles.linkedinstring\|null	Adresa profilului LinkedIn.Gol când nu s-a găsit niciunul	`null`	rar
profiles.otherarray	Alte pagini despre persoană, de exemplu articole de presă sau pagini de echipă, ca listă de adrese.Gol când nu s-a găsit niciuna	–	de obicei

O AI alcătuiește aceste informații din surse publice. Folosim pentru asta cea mai nouă tehnologie și investim mult în calitate; erori izolate sunt totuși posibile.

Participații și rețea

Două funcții extind profilul de persoană: shareholdings arată companiile la care persoana deține participații. network arată companiile și persoanele cu care este legată, pe două niveluri. Ambele se taxează doar dacă returnează date.

Câmp
Câmp	Semnificație	Exemplu	Disponibilitate
shareholdingsobject\|null	Companiile la care persoana deține azi participații.Gol când nu se cunoaște nicio participație`shareholdings`	–	parțial
shareholdings.holdings.currentarray	Participațiile actuale ca listă.	–	ca mai sus
shareholdings.holdings.current[].organizationobject	Compania cu entity_id, name, status, legal_form, address și registration, structurată ca în datele de bază.	–	ca mai sus
shareholdings.holdings.current[].ownership.percentagenumber\|null	Cota din capital în procente, de exemplu 33.33.	`100`	ca mai sus
shareholdings.holdings.current[].ownership.contributionobject\|null	Valoarea nominală a participației cu amount și currency.	–	ca mai sus
shareholdings.holdings.current[].as_ofstring\|null	Data informației în formatul YYYY-MM-DD.	`"2025-01-13"`	ca mai sus
shareholdings.summary.total_currentinteger	Numărul participațiilor actuale.	`3`	ca mai sus
networkobject\|null	Companiile și persoanele cu care persoana este legată, pe două niveluri. Structurat ca network din profilul de companie.`network` · de la Pro · Beta	–	de obicei
network.depthinteger	Câte niveluri acoperă rețeaua, socotit de la persoană. Persoana însăși este nivelul 0.	`2`	ca mai sus
network.nodesarray	Nodurile: persoane (PERSON) și companii (ORGANIZATION) cu entity_id, nume și nivelul lor. Persoana însăși are is_root true.	–	ca mai sus
network.connectionsarray	Legăturile dintre două noduri, fiecare cu kind (ROLE, OWNERSHIP sau GROUP), label, perioadă și is_current.	–	ca mai sus

Mai departe

fetch-organization Endpointul cu funcția related_persons și Timp real. fetch-person Preia profilul de persoană: parametri, costuri și erori. Găsește administratori și asociați Pas cu pas de la companie la persoanele ei. Asociați și participații Cui îi aparține o companie și la ce deține participații.