Henkilöt ja edustus – Dokumentaatio

Hae henkilöt

Pyydä ominaisuus related_persons. Vastauksessa on silloin avain related_persons kahdella listalla: current kaikille, joilla rooli on tänään, ja past kaikille, jotka ovat lähteneet. Jokainen rooli on oma merkintänsä. Esimerkkipyynnössämme yrityksestä Hetzner Online GmbH, Ansbach HRB 6089, current sisälsi kolme toimitusjohtajaa. Kaksi heistä esiintyi uudelleen listassa past entisen prokuransa kanssa. Kaikki esimerkkivastausten henkilötiedot ovat esimerkkidataa.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SINUN_API_AVAIMESI" \
  --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": "SINUN_API_AVAIMESI"},
    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": "SINUN_API_AVAIMESI" },
});
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 · Esimerkkivastaus: Hetzner Online GmbH ominaisuudella related_persons, lyhennetty nimeen ja henkilöihin

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
related_personsobject\|null	Kaikki yrityksen rekisteröidyt henkilöt jaettuna listoihin current ja past.`related_persons`	–	aina
related_persons.currentarray	Henkilöt, joilla rooli on tänään.	–	kuten yllä
related_persons.pastarray	Lähteneet henkilöt, samoilla kentillä kuin current. Kahdessa edustussäännössä latest korvaa kentän current: viimeinen versio ennen lähtöä.Tyhjä, kun kukaan ei ole lähtenyt rekisteröinnin jälkeen	–	yleensä

Henkilön kentät

Jokaisella listojen current ja past merkinnällä on samat kentät. Ilman Reaaliaikaa henkilöllä on sama entity_id kaikissa yritysprofiileissa ja henkilöprofiilissa. Näin tunnistat hänet eri yrityksistä. Reaaliaikakyselyn henkilöillä on omat tunnisteensa.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
related_persons.current[].entity_idstring\|null	Henkilön tunniste. Ilman Reaaliaikaa se on sama kaikissa yritysprofiileissa ja vastaa henkilöprofiilin entity_id:tä.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	aina
related_persons.current[].labelstring	Rooli kiinteänä arvona. Muutkin arvot ovat mahdollisia.Arvot: `MANAGING_DIRECTOR` toimitusjohtaja (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` väliaikainen toimitusjohtaja (Notgeschäftsführer), `BOARD` johtokunnan jäsen (Vorstand), `BOARD_CHAIR` johtokunnan puheenjohtaja, `DIRECTOR` toimiva johtaja, esimerkiksi SE:ssä, `PROCURA` prokuristi (Prokurist), `LIQUIDATOR` selvitysmies, `INSOLVENCY_ADMINISTRATOR` pesänhoitaja, `REPRESENTATIVE` pysyvä edustaja, `FULLY_LIABLE_PARTNER` vastuunalainen yhtiömies (persönlich haftender Gesellschafter), `LIMITED_PARTNER` äänetön yhtiömies (Kommanditist), `PARTNER` osakas, `OWNER` omistaja (Inhaber), `PROPRIETOR` omistaja (Inhaber), `TREASURER` yhdistyksen rahastonhoitaja, `SECRETARY` yhdistyksen sihteeri, `YOUTH_WARDEN` yhdistyksen nuorisovastaava, `WATER_WARDEN` yhdistyksen vesivastaava, `OTHER` muu rooli	`"MANAGING_DIRECTOR"`	kuten yllä
related_persons.current[].roleobject	Roolin nimi näyttämistä varten, kielillä de ja en, kumpikin pitkänä (long) ja lyhyenä (short), esimerkiksi Geschäftsführer ja GF.	–	kuten yllä
related_persons.current[].namestring	Koko nimi sellaisena kuin se on rekisterissä.	`"Paul Musterwald"`	kuten yllä
related_persons.current[].name_partsobject	Nimi osiin jaettuna lajittelua ja vertailua varten.	–	kuten yllä
related_persons.current[].name_parts.givenstring\|null	Etunimi, kaikki jos niitä on useita.	`"Paul"`	kuten yllä
related_persons.current[].name_parts.familystring\|null	Sukunimi.	`"Musterwald"`	kuten yllä
related_persons.current[].name_parts.canonical_namestring\|null	Nimi, yleensä muodossa ”Sukunimi, Etunimi”, lajittelua ja vertailua varten.	`"Musterwald, Paul"`	kuten yllä
related_persons.current[].name_parts.maidenstring\|null	Syntymänimi.Tyhjä, kun sitä ei ole rekisteröity	`null`	harvoin
related_persons.current[].name_parts.previous_namesarray\|null	Henkilön aiemmat nimet listana.Tyhjä, kun niitä ei ole rekisteröity	`null`	kuten yllä
related_persons.current[].titlesarray	Akateemiset tittelit, esimerkiksi Dr. Avain puuttuu, jos titteliä ei ole rekisteröity.	–	kuten yllä
related_persons.current[].birth_datestring\|null	Syntymäaika muodossa YYYY-MM-DD, kuten rekisteröity.Tyhjä, kun päivämäärää ei ole rekisteröity	`"1989-07-18"`	yleensä
related_persons.current[].locationobject\|null	Henkilön paikat.	–	kuten yllä
related_persons.current[].location.home.citystring\|null	Asuinpaikka, kuten rekisteröity. Rekisterissä ei ole täydellistä osoitetta.Tyhjä, kun asuinpaikkaa ei ole rekisteröity	`"Exempelingen i. Bay."`	kuten yllä
related_persons.current[].start_datestring\|null	Roolin alku muodossa YYYY-MM-DD.Tyhjä, kun alkua ei tiedetä, esimerkiksi Reaaliajalla	`"2019-01-04"`	kuten yllä
related_persons.current[].end_datestring\|null	Roolin loppu. Se on asetettu listan past henkilöille.Tyhjä, kun rooli on yhä voimassa	`null`	aina

Toimitusjohtajat ja johtokunta

GmbH:n tai UG:n toimitusjohtajilla (Geschäftsführer) on label MANAGING_DIRECTOR. AG:n, SE:n tai eG:n johtokunnan (Vorstand) tunnistat arvosta BOARD, sen puheenjohtajan arvosta BOARD_CHAIR. Kun yritys puretaan, edustuksen ottavat hoitaakseen selvitysmiehet arvolla LIQUIDATOR.

Tarkista roolit aina kentän label perusteella. Kentän role tekstit on tarkoitettu näyttämiseen.

Prokura

Prokura on rekisteröity valtuutus edustaa yritystä lähes kaikissa liiketoimissa. Prokuristeilla (Prokuristen) on label PROCURA. Saako joku toimia yksin vai vain yhdessä muiden kanssa, kerrotaan kentässä role_representation_scheme, esimerkiksi ”Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (yhteisprokura yhdessä johtokunnan jäsenen kanssa).

Vastuunalaiset yhtiömiehet

KG:ssä, OHG:ssä ja KGaA:ssa yhtiötä edustavat vastuunalaiset yhtiömiehet (persönlich haftende Gesellschafter). Heillä on label FULLY_LIABLE_PARTNER. KG:n äänettömät yhtiömiehet (Kommanditisten) ovat rekisterissä arvolla LIMITED_PARTNER, e.K.:n omistaja arvolla OWNER, PartG:n tai eGbR:n osakkaat arvolla PARTNER.

GmbH & Co. KG:ssä vastuunalainen yhtiömies on yleensä itse GmbH. Sen toimitusjohtajat löydät tuon GmbH:n yritysprofiilista.

Roolit yhtiömuodoittain

Yrityksen roolit määräytyvät sen yhtiömuodon mukaan. Taulukko näyttää, mitä labeleita kussakin yhtiömuodossa tyypillisesti näet. Kaikki labelit merkityksineen on lueteltu yllä kohdassa label.

Yhtiömuoto
Yhtiömuoto	Tyypilliset labelit
GmbH, UG	MANAGING_DIRECTOR, PROCURA, selvitystilassa LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, KG:ssä LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Edustusoikeus

Jokaisella henkilöllä on kaksi sääntökokonaisuutta. role_representation_scheme on hänen oma toimivaltansa, esimerkiksi ”einzelvertretungsberechtigt” (saa edustaa yksin). organization_representation_scheme on yrityksen yleinen sääntö, sama kuin representation_scheme perustiedoissa. Molemmissa on current ja history; entisillä henkilöillä latest korvaa kentän current.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
related_persons.current[].role_representation_schemeobject	Henkilön oma edustusoikeus, esimerkiksi ”einzelvertretungsberechtigt” (saa edustaa yksin) tai vapautus BGB:n § 181:n rajoituksista. current on voimassa oleva versio, history muutokset kentillä value, effective_from ja effective_to.`related_persons`	–	yleensä: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG harvoin: e.K.
related_persons.current[].organization_representation_schemeobject	Yrityksen yleiset edustussäännöt, mukana jokaisella henkilöllä. Rakenteeltaan kuten role_representation_scheme.	–	aina: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG yleensä: AG, SE, KGaA, e.K.

Henkilöt Reaaliajalla

Asetuksella realtime_mode=handelsregister-default tällä hetkellä rekisteröidyt henkilöt tulevat suoraan Handelsregisteristä (kaupparekisteri), myös ilman ominaisuutta related_persons. Silloin veloitetaan vain Reaaliaika, ei ominaisuutta. Vastauksessa on vain current.

Tässä listassa start_date ja end_date ovat tyhjiä, nimet voivat olla lyhyempiä ja henkilön entity_id voi poiketa siitä, joka hänellä on ilman Reaaliaikaa. Yhdistä henkilöt nimen ja syntymäajan perusteella.

Jos pyydät Reaaliajan ja ominaisuuden related_persons yhdessä, current tulee suorasta kyselystä ja past yritysprofiilista. Silloin myös ominaisuus veloitetaan.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
related_persons.current[].name_parts.aliasesarray	Nimen kirjoitusasut suorasta kyselystä, muodossa ”Sukunimi, Etunimi”. Vain Reaaliajalla.`related_persons`	–	aina

Henkilöprofiili

Henkilöprofiili (fetch-person) kuvaa yksittäisen henkilön: hänen roolinsa kaikissa yrityksissä, joihin hän liittyy, ja mitä julkiset verkkolähteet hänestä kertovat. Löydät henkilön hänen nimellään ja yrityksellä, jossa hänellä on tai on ollut rooli.

Henkilöprofiili sisältyy jokaiseen krediittitilaukseen Plussasta alkaen. Pyyntö kestää usein kymmenestä kolmeenkymmeneen sekuntia, koska tutkimme verkkoa. Aseta asiakasohjelmasi aikakatkaisuksi vähintään 120 sekuntia.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: SINUN_API_AVAIMESI" \
  --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": "SINUN_API_AVAIMESI"},
    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": "SINUN_API_AVAIMESI" },
});
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 · Esimerkkivastaus: Max Felix Mustermannin (esimerkkidata) henkilöprofiili, Hetzner Online GmbH, lyhennetty

Henkilö

Nimi, syntymäaika ja asuinpaikka tulevat rekisteristä. entity_id on sama kuin yritysprofiilien kentässä related_persons ilman Reaaliaikaa.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
entity_idstring	Henkilön tunniste. Sama tunniste esiintyy yritysprofiilien kentässä related_persons ilman Reaaliaikaa.Henkilöprofiili	`"08ed5f967956831ca6588930fd2693ed"`	aina
namestring	Koko nimi sellaisena kuin se on rekisterissä.	`"Max Felix Mustermann"`	kuten yllä
birth_datestring\|null	Syntymäaika muodossa YYYY-MM-DD, kuten rekisteröity.Tyhjä, kun päivämäärää ei ole rekisteröity	`"1976-01-15"`	yleensä
name_partsobject	Nimi osiin jaettuna, rakenteeltaan kuten kentässä related_persons.	–	aina
name_parts.givenstring\|null	Etunimi, kaikki jos niitä on useita.	`"Max Felix"`	kuten yllä
name_parts.familystring\|null	Sukunimi.	`"Mustermann"`	kuten yllä
name_parts.canonical_namestring\|null	Nimi, yleensä muodossa ”Sukunimi, Etunimi”, lajittelua ja vertailua varten.	`"Mustermann, Max Felix"`	kuten yllä
name_parts.maidenstring\|null	Syntymänimi.Tyhjä, kun sitä ei ole rekisteröity	`null`	harvoin
name_parts.previous_namesarray\|null	Henkilön aiemmat nimet listana.Tyhjä, kun niitä ei ole rekisteröity	`null`	kuten yllä
locationobject	Henkilön paikat.	–	yleensä
location.home.citystring\|null	Asuinpaikka, kuten rekisteröity.Tyhjä, kun asuinpaikkaa ei ole rekisteröity	`"Musterheim"`	kuten yllä

Roolit ja yhteydet

handelsregister_roles listaa henkilön jokaisen rekisteröidyn roolin yrityksineen ja ajanjaksoineen. Yrityksen entity_id:llä haet sen yritysprofiilin. affiliations tiivistää yhteydet lyhyesti rekisteristä ja verkosta.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
handelsregister_rolesarray	Henkilön rekisteröidyt roolit yrityksineen ja ajanjaksoineen, nykyiset ja entiset.Henkilöprofiili	–	aina
handelsregister_roles[].entity_idstring	Yrityksen entity_id, yritysprofiilia varten parametrissa q.	`"0b3435f83ce8591300625100815d4583"`	kuten yllä
handelsregister_roles[].namestring	Yrityksen nimi.	`"Hetzner Online GmbH"`	kuten yllä
handelsregister_roles[].labelstring	Rooli kiinteänä arvona, samat arvot kuin label kentässä related_persons, esimerkiksi MANAGING_DIRECTOR, BOARD, PROCURA tai LIMITED_PARTNER.	`"BOARD"`	kuten yllä
handelsregister_roles[].roleobject	Roolin nimi näyttämistä varten, tekstinä kielillä de ja en.	–	kuten yllä
handelsregister_roles[].start_datestring\|null	Roolin alku muodossa YYYY-MM-DD.Tyhjä, kun alkua ei tiedetä	`"2002-10-15"`	yleensä
handelsregister_roles[].end_datestring\|null	Roolin loppu.Tyhjä, kun rooli on yhä voimassa	`"2015-07-28"`	aina
affiliationsarray	Yritykset, joihin henkilö liittyy, kukin yhteyden lajeineen. Tiivistetty rekisteristä ja verkkolähteistä.	–	kuten yllä
affiliations[].organizationstring	Yrityksen nimi.	`"ENSoXX Holding AG"`	kuten yllä
affiliations[].relationstring	Yhteyden laji saksankielisenä tekstinä, esimerkiksi Geschäftsführer (toimitusjohtaja), Prokura tai Kommanditist (äänetön yhtiömies).	`"Vorstandsmitglied"`	kuten yllä

Verkkotutkimus

Lyhyen elämäkerran, osaamisalueet, yhteystiedot ja lähteet keräämme julkisista verkkolähteistä. Niiden määrä riippuu siitä, kuinka näkyvä henkilö on verkossa.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
biostring\|null	Henkilön lyhyt elämäkerta yhdessä tai kahdessa lauseessa, saksaksi.Tyhjä, kun verkossa on henkilöstä liian vähän tietoa (silloin null)Henkilöprofiili	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	yleensä
expertisearray	Henkilön osaamisalueet ja aiheet listana.Tyhjä, kun verkossa on henkilöstä liian vähän tietoa	–	kuten yllä
contactobject	Julkisesti ilmoitetut yhteystiedot, kentät emails ja phones.	–	aina
contact.emailsarray	Sähköpostiosoitteet listana.Tyhjä, kun osoitetta ei löytynyt	–	harvoin
contact.emails[].addressstring	Sähköpostiosoite.	`"[email protected]"`	kuten yllä
contact.emails[].typestring	Osoitteen laji. organization tarkoittaa: yrityksen osoite, ei yksityinen.	`"organization"`	kuten yllä
contact.emails[].labelstring	Mihin osoite on tarkoitettu, lyhyenä tekstinä.	`"Allgemeine Unternehmenskontakt-E-Mail"`	kuten yllä
contact.phonesarray	Puhelinnumerot listana.Tyhjä, kun numeroa ei löytynyt	–	kuten yllä
contact.phones[].numberstring	Numero, yleensä kansainvälisessä muodossa.	`"+49374574447100"`	kuten yllä
contact.phones[].typestring	Numeron laji. organization tarkoittaa: yrityksen numero.	`"organization"`	kuten yllä
contact.phones[].entitystring	Yritys, jolle numero kuuluu.	`"Hetzner Online GmbH"`	kuten yllä
contact.phones[].labelstring	Mihin numero on tarkoitettu, esimerkiksi vaihde tai faksi.	`"Öffentliche Unternehmens-Telefonnummer"`	kuten yllä
profilesobject	Henkilöä koskevat verkkosivut, kentät linkedin ja other.	–	aina
profiles.linkedinstring\|null	LinkedIn-profiilin osoite.Tyhjä, kun sellaista ei löytynyt	`null`	harvoin
profiles.otherarray	Muut henkilöä koskevat sivut, esimerkiksi lehtiartikkelit tai tiimisivut, osoitelistana.Tyhjä, kun sellaisia ei löytynyt	–	yleensä

Nämä tiedot kokoaa tekoäly julkisista lähteistä. Käytämme siihen uusinta tekniikkaa ja panostamme paljon laatuun; yksittäiset virheet ovat silti mahdollisia.

Omistukset ja verkosto

Kaksi ominaisuutta laajentaa henkilöprofiilia: shareholdings näyttää yritykset, joissa henkilöllä on omistusosuus. network näyttää yritykset ja henkilöt, joihin hän liittyy, kahden tason yli. Kummastakin veloitetaan vain, jos se palauttaa dataa.

Kenttä
Kenttä	Merkitys	Esimerkki	Saatavuus
shareholdingsobject\|null	Yritykset, joissa henkilöllä on tänään omistusosuus.Tyhjä, kun omistuksia ei tunneta`shareholdings`	–	osittain
shareholdings.holdings.currentarray	Nykyiset omistukset listana.	–	kuten yllä
shareholdings.holdings.current[].organizationobject	Yritys kentillä entity_id, name, status, legal_form, address ja registration, rakenteeltaan kuten perustiedoissa.	–	kuten yllä
shareholdings.holdings.current[].ownership.percentagenumber\|null	Osuus pääomasta prosentteina, esimerkiksi 33.33.	`100`	kuten yllä
shareholdings.holdings.current[].ownership.contributionobject\|null	Omistusosuuden nimellismäärä kentillä amount ja currency.	–	kuten yllä
shareholdings.holdings.current[].as_ofstring\|null	Tiedon päivämäärä muodossa YYYY-MM-DD.	`"2025-01-13"`	kuten yllä
shareholdings.summary.total_currentinteger	Nykyisten omistusten lukumäärä.	`3`	kuten yllä
networkobject\|null	Yritykset ja henkilöt, joihin henkilö liittyy, kahden tason yli. Rakenteeltaan kuten network yritysprofiilissa.`network` · Pro ja ylemmät · Beta	–	yleensä
network.depthinteger	Kuinka monta tasoa verkosto kattaa henkilöstä laskien. Henkilö itse on taso 0.	`2`	kuten yllä
network.nodesarray	Solmut: henkilöt (PERSON) ja yritykset (ORGANIZATION) kentillä entity_id, name ja taso. Henkilöllä itsellään on is_root true.	–	kuten yllä
network.connectionsarray	Kahden solmun väliset yhteydet, kullakin kind (ROLE, OWNERSHIP tai GROUP), label, ajanjakso ja is_current.	–	kuten yllä

Seuraavaksi

fetch-organization Päätepiste ominaisuudella related_persons ja Reaaliajalla. fetch-person Hae henkilöprofiili: parametrit, kustannukset ja virheet. Löydä toimitusjohtajat ja osakkaat Vaihe vaiheelta yrityksestä sen henkilöihin. Osakkaat ja omistukset Kuka omistaa yrityksen ja missä sillä on omistuksia.