Personer og representasjon – Dokumentasjon

Hent personer

Be om funksjonen related_persons. Svaret inneholder da nøkkelen related_persons med to lister: current for alle som har rollen sin i dag, og past for alle som har gått ut. Hver rolle er en egen oppføring. I eksempelforespørselen vår for Hetzner Online GmbH, Ansbach HRB 6089, inneholdt current tre daglige ledere. To av dem dukket opp igjen i past med sin tidligere Prokura. Alle personopplysninger i eksempelsvarene er eksempeldata.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --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": "YOUR_API_KEY"},
    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": "YOUR_API_KEY" },
});
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 · Eksempelsvar: Hetzner Online GmbH med funksjonen related_persons, forkortet til navn og personer

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
related_personsobject\|null	Alle registrerte personer i firmaet, fordelt på current og past.`related_persons`	–	alltid
related_persons.currentarray	Personer som har rollen sin i dag.	–	som ovenfor
related_persons.pastarray	Personer som har gått ut, med de samme feltene som current. I de to representasjonsreglene erstatter latest current: den siste versjonen før de gikk ut.Tom når ingen har gått ut siden registreringen	–	som regel

Feltene for en person

Hver oppføring i current og past har de samme feltene. Uten Sanntid har en person den samme entity_id i alle firmaprofiler og i personprofilen. Slik kjenner du personen igjen på tvers av firmaer. Personer fra en Sanntid-spørring har egne ID-er.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
related_persons.current[].entity_idstring\|null	Personens ID. Uten Sanntid er den den samme i alle firmaprofiler og stemmer med entity_id i personprofilen.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	alltid
related_persons.current[].labelstring	Rolle som fast verdi. Andre verdier er mulige.Verdier: `MANAGING_DIRECTOR` daglig leder (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` nøddaglig leder (Notgeschäftsführer), `BOARD` styremedlem (Vorstand), `BOARD_CHAIR` styreleder, `DIRECTOR` administrerende direktør, for eksempel i en SE, `PROCURA` prokurist (Prokurist), `LIQUIDATOR` avviklingsstyre, `INSOLVENCY_ADMINISTRATOR` bostyrer, `REPRESENTATIVE` fast representant, `FULLY_LIABLE_PARTNER` komplementar (persönlich haftender Gesellschafter), `LIMITED_PARTNER` kommandittist (Kommanditist), `PARTNER` partner, `OWNER` innehaver (Inhaber), `PROPRIETOR` innehaver (Inhaber), `TREASURER` kasserer i en forening, `SECRETARY` sekretær i en forening, `YOUTH_WARDEN` ungdomsleder i en forening, `WATER_WARDEN` vannoppsynsmann i en forening, `OTHER` annen rolle	`"MANAGING_DIRECTOR"`	som ovenfor
related_persons.current[].roleobject	Rollenavn for visning, på de og en, hver lang (long) og kort (short), for eksempel Geschäftsführer og GF.	–	som ovenfor
related_persons.current[].namestring	Fullt navn slik det står i registeret.	`"Paul Musterwald"`	som ovenfor
related_persons.current[].name_partsobject	Navnet delt opp i delene sine, for sortering og matching.	–	som ovenfor
related_persons.current[].name_parts.givenstring\|null	Fornavn, alle hvis det er flere.	`"Paul"`	som ovenfor
related_persons.current[].name_parts.familystring\|null	Etternavn.	`"Musterwald"`	som ovenfor
related_persons.current[].name_parts.canonical_namestring\|null	Navnet, som regel i formen «Etternavn, Fornavn», for sortering og matching.	`"Musterwald, Paul"`	som ovenfor
related_persons.current[].name_parts.maidenstring\|null	Fødenavn.Tom når det ikke er registrert noe	`null`	sjelden
related_persons.current[].name_parts.previous_namesarray\|null	Personens tidligere navn som liste.Tom når det ikke er registrert noen	`null`	som ovenfor
related_persons.current[].titlesarray	Akademiske titler, for eksempel Dr. Nøkkelen mangler hvis ingen tittel er registrert.	–	som ovenfor
related_persons.current[].birth_datestring\|null	Fødselsdato i formatet YYYY-MM-DD, slik den er registrert.Tom når ingen dato er registrert	`"1989-07-18"`	som regel
related_persons.current[].locationobject\|null	Personens steder.	–	som ovenfor
related_persons.current[].location.home.citystring\|null	Bosted, slik det er registrert. Registeret inneholder ingen fullstendig adresse.Tom når ikke noe bosted er registrert	`"Exempelingen i. Bay."`	som ovenfor
related_persons.current[].start_datestring\|null	Start for rollen i formatet YYYY-MM-DD.Tom når starten ikke er kjent, for eksempel med Sanntid	`"2019-01-04"`	som ovenfor
related_persons.current[].end_datestring\|null	Slutt for rollen. Den er satt for personer i past.Tom når rollen fortsatt består	`null`	alltid

Daglige ledere og styre

De daglige lederne (Geschäftsführer) i en GmbH eller UG har etiketten MANAGING_DIRECTOR. Styret (Vorstand) i en AG, SE eller eG kjenner du igjen på BOARD, styrelederen på BOARD_CHAIR. Når et firma oppløses, overtar avviklingsstyret med LIQUIDATOR representasjonen.

Sjekk alltid roller via label. Tekstene i role er ment for visning.

Prokura

Prokura er den registrerte fullmakten til å representere firmaet i nesten alle forretninger. Prokurister (Prokuristen) har etiketten PROCURA. Om noen kan handle alene eller bare sammen med andre, står i role_representation_scheme, for eksempel «Gesamtprokura gemeinsam mit einem Vorstandsmitglied» (felles prokura sammen med et styremedlem).

Komplementarer

I et KG, OHG og KGaA representerer de personlig ansvarlige deltakerne (persönlich haftende Gesellschafter) firmaet. De har etiketten FULLY_LIABLE_PARTNER. Kommandittistene (Kommanditisten) i et KG står i registeret med LIMITED_PARTNER, innehaveren av et e.K. med OWNER, partnerne i et PartG eller eGbR med PARTNER.

I et GmbH & Co. KG er komplementaren som regel selv en GmbH. De daglige lederne finner du i firmaprofilen til denne GmbH-en.

Roller etter selskapsform

Hvilke roller et firma har, følger av selskapsformen. Tabellen viser hvilke etiketter du typisk ser per selskapsform. Alle etiketter med betydning står ovenfor under label.

Selskapsform
Selskapsform	Typiske etiketter
GmbH, UG	MANAGING_DIRECTOR, PROCURA, under avvikling LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, for et KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Representasjonsrett

Hver person kommer med to sett regler. role_representation_scheme er personens egen fullmakt, for eksempel «einzelvertretungsberechtigt» (kan representere alene). organization_representation_scheme er firmaets generelle regel, den samme som representation_scheme i stamdataene. Begge har current og history; for tidligere personer erstatter latest current.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
related_persons.current[].role_representation_schemeobject	Personens egen representasjonsrett, for eksempel «einzelvertretungsberechtigt» (kan representere alene) eller en fritakelse fra § 181 BGB. current er versjonen som gjelder, history endringene med value, effective_from og effective_to.`related_persons`	–	som regel: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG sjelden: e.K.
related_persons.current[].organization_representation_schemeobject	Firmaets generelle representasjonsregler, med på hver person. Bygget opp som role_representation_scheme.	–	alltid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG som regel: AG, SE, KGaA, e.K.

Personer med Sanntid

Med realtime_mode=handelsregister-default kommer personene som er registrert nå, rett fra Handelsregister, også uten funksjonen related_persons. Da belastes bare Sanntid, ikke funksjonen. Svaret inneholder bare current.

I denne listen er start_date og end_date tomme, navn kan være kortere, og en persons entity_id kan avvike fra den uten Sanntid. Match personer via navn og fødselsdato.

Ber du om Sanntid og related_persons sammen, kommer current fra live-spørringen og past fra firmaprofilen. Da belastes også funksjonen.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
related_persons.current[].name_parts.aliasesarray	Skrivemåter av navnet fra live-spørringen, i formen «Etternavn, Fornavn». Bare med Sanntid.`related_persons`	–	alltid

Personprofil

Personprofilen (fetch-person) beskriver én enkelt person: rollene personen har i alle firmaer hen er knyttet til, og hva offentlige nettkilder sier om personen. Du finner personen via navnet og et firma der hen har eller hadde en rolle.

Personprofilen følger med hvert kredittabonnement fra Plus. En forespørsel tar ofte ti til tretti sekunder, fordi vi undersøker nettet. Sett tidsavbruddet i klienten din til minst 120 sekunder.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: YOUR_API_KEY" \
  --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": "YOUR_API_KEY"},
    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": "YOUR_API_KEY" },
});
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 · Eksempelsvar: personprofilen til Max Felix Mustermann (eksempeldata) hos Hetzner Online GmbH, forkortet

Personen

Navn, fødselsdato og bosted kommer fra registeret. entity_id er den samme som i related_persons i firmaprofilene uten Sanntid.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
entity_idstring	Personens ID. Den samme ID-en står i related_persons i firmaprofilene uten Sanntid.Personprofil	`"08ed5f967956831ca6588930fd2693ed"`	alltid
namestring	Fullt navn slik det står i registeret.	`"Max Felix Mustermann"`	som ovenfor
birth_datestring\|null	Fødselsdato i formatet YYYY-MM-DD, slik den er registrert.Tom når ingen dato er registrert	`"1976-01-15"`	som regel
name_partsobject	Navnet delt opp i delene sine, bygget opp som i related_persons.	–	alltid
name_parts.givenstring\|null	Fornavn, alle hvis det er flere.	`"Max Felix"`	som ovenfor
name_parts.familystring\|null	Etternavn.	`"Mustermann"`	som ovenfor
name_parts.canonical_namestring\|null	Navnet, som regel i formen «Etternavn, Fornavn», for sortering og matching.	`"Mustermann, Max Felix"`	som ovenfor
name_parts.maidenstring\|null	Fødenavn.Tom når det ikke er registrert noe	`null`	sjelden
name_parts.previous_namesarray\|null	Personens tidligere navn som liste.Tom når det ikke er registrert noen	`null`	som ovenfor
locationobject	Personens steder.	–	som regel
location.home.citystring\|null	Bosted, slik det er registrert.Tom når ikke noe bosted er registrert	`"Musterheim"`	som ovenfor

Roller og forbindelser

handelsregister_roles lister opp hver registrert rolle personen har, med firma og periode. Bruk et firmas entity_id til å hente firmaprofilen. affiliations oppsummerer forbindelsene kort, fra register og nett.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
handelsregister_rolesarray	Personens registrerte roller med firma og periode, nåværende og tidligere.Personprofil	–	alltid
handelsregister_roles[].entity_idstring	Firmaets entity_id, for en firmaprofil i parameteren q.	`"0b3435f83ce8591300625100815d4583"`	som ovenfor
handelsregister_roles[].namestring	Firmaets navn.	`"Hetzner Online GmbH"`	som ovenfor
handelsregister_roles[].labelstring	Rolle som fast verdi, de samme verdiene som label i related_persons, for eksempel MANAGING_DIRECTOR, BOARD, PROCURA eller LIMITED_PARTNER.	`"BOARD"`	som ovenfor
handelsregister_roles[].roleobject	Rollenavn for visning, som tekst på de og en.	–	som ovenfor
handelsregister_roles[].start_datestring\|null	Start for rollen i formatet YYYY-MM-DD.Tom når starten ikke er kjent	`"2002-10-15"`	som regel
handelsregister_roles[].end_datestring\|null	Slutt for rollen.Tom når rollen fortsatt består	`"2015-07-28"`	alltid
affiliationsarray	Firmaene personen er knyttet til, hvert med typen forbindelse. Oppsummert fra register- og nettkilder.	–	som ovenfor
affiliations[].organizationstring	Firmaets navn.	`"ENSoXX Holding AG"`	som ovenfor
affiliations[].relationstring	Typen forbindelse som tysk tekst, for eksempel Geschäftsführer (daglig leder), Prokura eller Kommanditist (kommandittist).	`"Vorstandsmitglied"`	som ovenfor

Research på nettet

Den korte biografien, fagområdene, kontaktkanalene og kildene samler vi fra offentlige nettkilder. Hvor mye som finnes, avhenger av hvor synlig personen er på nettet.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
biostring\|null	Kort biografi om personen i én eller to setninger, på tysk.Tom når nettet har for lite om personen (da null)Personprofil	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	som regel
expertisearray	Personens fagområder og temaer som liste.Tom når nettet har for lite om personen	–	som ovenfor
contactobject	Offentlig oppførte kontaktkanaler, med emails og phones.	–	alltid
contact.emailsarray	E-postadresser som liste.Tom når ingen adresse ble funnet	–	sjelden
contact.emails[].addressstring	E-postadressen.	`"[email protected]"`	som ovenfor
contact.emails[].typestring	Typen adresse. organization betyr: en adresse til firmaet, ikke en privat.	`"organization"`	som ovenfor
contact.emails[].labelstring	Hva adressen er til, som kort tekst.	`"Allgemeine Unternehmenskontakt-E-Mail"`	som ovenfor
contact.phonesarray	Telefonnumre som liste.Tom når ikke noe nummer ble funnet	–	som ovenfor
contact.phones[].numberstring	Nummeret, som regel i internasjonalt format.	`"+49374574447100"`	som ovenfor
contact.phones[].typestring	Typen nummer. organization betyr: et nummer til firmaet.	`"organization"`	som ovenfor
contact.phones[].entitystring	Firmaet nummeret hører til.	`"Hetzner Online GmbH"`	som ovenfor
contact.phones[].labelstring	Hva nummeret er til, for eksempel sentralbord eller faks.	`"Öffentliche Unternehmens-Telefonnummer"`	som ovenfor
profilesobject	Nettsider om personen, med linkedin og other.	–	alltid
profiles.linkedinstring\|null	Adressen til LinkedIn-profilen.Tom når ingen ble funnet	`null`	sjelden
profiles.otherarray	Andre sider om personen, for eksempel presseartikler eller teamsider, som liste med adresser.Tom når ingen ble funnet	–	som regel

En AI setter sammen denne informasjonen fra offentlige kilder. Vi bruker den nyeste teknologien til dette og investerer mye i kvalitet; enkelte feil er likevel mulige.

Eierandeler og nettverk

To funksjoner utvider personprofilen: shareholdings viser firmaene personen eier andeler i. network viser firmaene og personene hen er knyttet til, over to nivåer. Begge belastes bare hvis de returnerer data.

Felt
Felt	Betydning	Eksempel	Tilgjengelighet
shareholdingsobject\|null	Firmaer personen eier andeler i i dag.Tom når ingen eierandel er kjent`shareholdings`	–	delvis
shareholdings.holdings.currentarray	De nåværende eierandelene som liste.	–	som ovenfor
shareholdings.holdings.current[].organizationobject	Firmaet med entity_id, name, status, legal_form, address og registration, bygget opp som i stamdataene.	–	som ovenfor
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel av kapitalen i prosent, for eksempel 33.33.	`100`	som ovenfor
shareholdings.holdings.current[].ownership.contributionobject\|null	Pålydende beløp for eierandelen med amount og currency.	–	som ovenfor
shareholdings.holdings.current[].as_ofstring\|null	Dato for opplysningen i formatet YYYY-MM-DD.	`"2025-01-13"`	som ovenfor
shareholdings.summary.total_currentinteger	Antall nåværende eierandeler.	`3`	som ovenfor
networkobject\|null	Firmaer og personer personen er knyttet til, over to nivåer. Bygget opp som network i firmaprofilen.`network` · fra Pro · Beta	–	som regel
network.depthinteger	Hvor mange nivåer nettverket omfatter, regnet fra personen. Personen selv er nivå 0.	`2`	som ovenfor
network.nodesarray	Nodene: personer (PERSON) og firmaer (ORGANIZATION) med entity_id, navn og nivå. Personen selv har is_root true.	–	som ovenfor
network.connectionsarray	Forbindelsene mellom to noder, hver med kind (ROLE, OWNERSHIP eller GROUP), label, periode og is_current.	–	som ovenfor

Videre

fetch-organization Endepunktet med funksjonen related_persons og Sanntid. fetch-person Hent personprofilen: parametere, kostnader og feil. Finn daglige ledere og eiere Steg for steg fra firmaet til personene. Eiere og eierandeler Hvem som eier et firma, og hva det har eierandeler i.