Personer og tegning – Dokumentation

Hent personer

Anmod om featuren related_persons. Svaret indeholder så nøglen related_persons med to lister: current for alle, der har deres rolle i dag, og past for alle, der er fratrådt. Hver rolle er sin egen post. I vores eksempelforespørgsel for Hetzner Online GmbH, Ansbach HRB 6089, indeholdt current tre direktører. To af dem optrådte igen i past med deres tidligere prokura. Alle persondata i eksempelsvarene er eksempeldata.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NOEGLE" \
  --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": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
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 featuren related_persons, forkortet til navn og personer

Felt
Felt	Betydning	Eksempel	Tilgængelighed
related_personsobject\|null	Alle registrerede personer i virksomheden, opdelt i current og past.`related_persons`	–	altid
related_persons.currentarray	Personer, der har deres rolle i dag.	–	som ovenfor
related_persons.pastarray	Personer, der er fratrådt, med de samme felter som current. I de to tegningsregler erstatter latest current: den sidste version før fratrædelsen.Tom, når ingen er fratrådt siden registreringen	–	oftest

Felter for en person

Hver post i current og past har de samme felter. Uden Realtid har en person samme entity_id i alle virksomhedsprofiler og i personprofilen. Så kan du genkende personen på tværs af virksomheder. Personer fra en Realtid-forespørgsel har deres egne ID’er.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
related_persons.current[].entity_idstring\|null	Personens ID. Uden Realtid er det det samme i alle virksomhedsprofiler og matcher entity_id i personprofilen.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	altid
related_persons.current[].labelstring	Rolle som fast værdi. Andre værdier er mulige.Værdier: `MANAGING_DIRECTOR` direktør (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` nøddirektør (Notgeschäftsführer), `BOARD` medlem af direktionen (Vorstand), `BOARD_CHAIR` formand for direktionen, `DIRECTOR` administrerende direktør, f.eks. for en SE, `PROCURA` prokurist (Prokurist), `LIQUIDATOR` likvidator, `INSOLVENCY_ADMINISTRATOR` kurator i insolvensbehandlingen, `REPRESENTATIVE` fast repræsentant, `FULLY_LIABLE_PARTNER` komplementar (persönlich haftender Gesellschafter), `LIMITED_PARTNER` kommanditist (Kommanditist), `PARTNER` partner, `OWNER` indehaver (Inhaber), `PROPRIETOR` indehaver (Inhaber), `TREASURER` kasserer i en forening, `SECRETARY` sekretær i en forening, `YOUTH_WARDEN` ungdomsleder i en forening, `WATER_WARDEN` vandansvarlig i en forening, `OTHER` anden rolle	`"MANAGING_DIRECTOR"`	som ovenfor
related_persons.current[].roleobject	Rollenavn til visning, på de og en, hver lang (long) og kort (short), f.eks. Geschäftsführer og GF.	–	som ovenfor
related_persons.current[].namestring	Fulde navn, som det står i registret.	`"Paul Musterwald"`	som ovenfor
related_persons.current[].name_partsobject	Navnet opdelt i sine dele, til sortering og matching.	–	som ovenfor
related_persons.current[].name_parts.givenstring\|null	Fornavn, alle hvis der er flere.	`"Paul"`	som ovenfor
related_persons.current[].name_parts.familystring\|null	Efternavn.	`"Musterwald"`	som ovenfor
related_persons.current[].name_parts.canonical_namestring\|null	Navnet, som regel i formen «Efternavn, Fornavn», til sortering og matching.	`"Musterwald, Paul"`	som ovenfor
related_persons.current[].name_parts.maidenstring\|null	Fødenavn.Tom, når der ikke er registreret noget	`null`	sjældent
related_persons.current[].name_parts.previous_namesarray\|null	Personens tidligere navne som liste.Tom, når der ikke er registreret nogen	`null`	som ovenfor
related_persons.current[].titlesarray	Akademiske titler, f.eks. Dr. Nøglen mangler, hvis der ikke er registreret nogen titel.	–	som ovenfor
related_persons.current[].birth_datestring\|null	Fødselsdato i formatet YYYY-MM-DD, som registreret.Tom, når der ikke er registreret nogen dato	`"1989-07-18"`	oftest
related_persons.current[].locationobject\|null	Personens steder.	–	som ovenfor
related_persons.current[].location.home.citystring\|null	Bopæl, som registreret. Registret indeholder ingen fuld adresse.Tom, når der ikke er registreret nogen bopæl	`"Exempelingen i. Bay."`	som ovenfor
related_persons.current[].start_datestring\|null	Rollens start i formatet YYYY-MM-DD.Tom, når starten ikke er kendt, f.eks. med Realtid	`"2019-01-04"`	som ovenfor
related_persons.current[].end_datestring\|null	Rollens afslutning. Den er sat for personer i past.Tom, når rollen stadig består	`null`	altid

Direktører og direktion

Direktørerne (Geschäftsführer) i en GmbH eller UG har label MANAGING_DIRECTOR. Direktionen (Vorstand) i en AG, SE eller eG genkender du på BOARD, formanden på BOARD_CHAIR. Når en virksomhed opløses, overtager likvidatorer med LIQUIDATOR tegningen.

Tjek altid roller via label. Teksterne i role er beregnet til visning.

Prokura

Prokura er den registrerede fuldmagt til at repræsentere virksomheden i næsten alle forretninger. Prokurister (Prokuristen) har label PROCURA. Om nogen må handle alene eller kun sammen med andre, står i role_representation_scheme, f.eks. «Gesamtprokura gemeinsam mit einem Vorstandsmitglied» (fælles prokura sammen med et direktionsmedlem).

Komplementarer

I en KG, OHG og KGaA repræsenterer de personligt hæftende selskabsdeltagere (persönlich haftende Gesellschafter) virksomheden. De har label FULLY_LIABLE_PARTNER. Kommanditister (Kommanditisten) i en KG står i registret med LIMITED_PARTNER, indehaveren af en e.K. med OWNER, partnerne i en PartG eller eGbR med PARTNER.

I en GmbH & Co. KG er komplementaren som regel selv en GmbH. Dens direktører finder du i den pågældende GmbH’s virksomhedsprofil.

Roller efter selskabsform

Hvilke roller en virksomhed har, følger af dens selskabsform. Tabellen viser, hvilke labels du typisk ser pr. selskabsform. Alle labels med deres betydning står ovenfor under label.

Selskabsform
Selskabsform	Typiske labels
GmbH, UG	MANAGING_DIRECTOR, PROCURA, under likvidation LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, for en KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Tegningsret

Hver person kommer med to sæt regler. role_representation_scheme er personens egen beføjelse, f.eks. «einzelvertretungsberechtigt» (må tegne alene). organization_representation_scheme er virksomhedens generelle regel, den samme som representation_scheme i stamdataene. Begge har current og history; for tidligere personer erstatter latest current.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
related_persons.current[].role_representation_schemeobject	Personens egen tegningsret, f.eks. «einzelvertretungsberechtigt» (må tegne alene) eller en fritagelse fra § 181 BGB. current er den gældende version, history ændringerne med value, effective_from og effective_to.`related_persons`	–	oftest: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG sjældent: e.K.
related_persons.current[].organization_representation_schemeobject	Virksomhedens generelle tegningsregler, medtaget for hver person. Struktureret som role_representation_scheme.	–	altid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG oftest: AG, SE, KGaA, e.K.

Personer med Realtid

Med realtime_mode=handelsregister-default kommer de aktuelt registrerede personer direkte fra Handelsregister (det tyske handelsregister), også uden featuren related_persons. Så afregnes kun Realtid, ikke featuren. Svaret indeholder kun current.

I denne liste er start_date og end_date tomme, navne kan være kortere, og en persons entity_id kan afvige fra den uden Realtid. Match personer via navn og fødselsdato.

Anmoder du om Realtid og related_persons sammen, kommer current fra live-forespørgslen og past fra virksomhedsprofilen. Så afregnes featuren også.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
related_persons.current[].name_parts.aliasesarray	Stavemåder af navnet fra live-forespørgslen, i formen «Efternavn, Fornavn». Kun med Realtid.`related_persons`	–	altid

Personprofil

Personprofilen (fetch-person) beskriver en enkelt person: personens roller i alle virksomheder, personen er forbundet med, og hvad offentlige webkilder siger om personen. Du finder personen via navnet og en virksomhed, hvor personen har eller havde en rolle.

Personprofilen følger med hvert kreditabonnement fra Plus. En forespørgsel tager ofte ti til tredive sekunder, fordi vi researcher på nettet. Sæt din klients timeout til mindst 120 sekunder.

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

Personen

Navn, fødselsdato og bopæl kommer fra registret. entity_id er den samme som i related_persons i virksomhedsprofilerne uden Realtid.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
entity_idstring	Personens ID. Det samme ID optræder i related_persons i virksomhedsprofilerne uden Realtid.Personprofil	`"08ed5f967956831ca6588930fd2693ed"`	altid
namestring	Fulde navn, som det står i registret.	`"Max Felix Mustermann"`	som ovenfor
birth_datestring\|null	Fødselsdato i formatet YYYY-MM-DD, som registreret.Tom, når der ikke er registreret nogen dato	`"1976-01-15"`	oftest
name_partsobject	Navnet opdelt i sine dele, struktureret som i related_persons.	–	altid
name_parts.givenstring\|null	Fornavn, alle hvis der er flere.	`"Max Felix"`	som ovenfor
name_parts.familystring\|null	Efternavn.	`"Mustermann"`	som ovenfor
name_parts.canonical_namestring\|null	Navnet, som regel i formen «Efternavn, Fornavn», til sortering og matching.	`"Mustermann, Max Felix"`	som ovenfor
name_parts.maidenstring\|null	Fødenavn.Tom, når der ikke er registreret noget	`null`	sjældent
name_parts.previous_namesarray\|null	Personens tidligere navne som liste.Tom, når der ikke er registreret nogen	`null`	som ovenfor
locationobject	Personens steder.	–	oftest
location.home.citystring\|null	Bopæl, som registreret.Tom, når der ikke er registreret nogen bopæl	`"Musterheim"`	som ovenfor

Roller og forbindelser

handelsregister_roles viser hver registreret rolle for personen med virksomhed og periode. Brug en virksomheds entity_id til at hente dens virksomhedsprofil. affiliations opsummerer forbindelserne kort, fra register og web.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
handelsregister_rolesarray	Personens registrerede roller med virksomhed og periode, nuværende og tidligere.Personprofil	–	altid
handelsregister_roles[].entity_idstring	Virksomhedens entity_id, til en virksomhedsprofil i parameteren q.	`"0b3435f83ce8591300625100815d4583"`	som ovenfor
handelsregister_roles[].namestring	Virksomhedens navn.	`"Hetzner Online GmbH"`	som ovenfor
handelsregister_roles[].labelstring	Rolle som fast værdi, de samme værdier som label i related_persons, f.eks. MANAGING_DIRECTOR, BOARD, PROCURA eller LIMITED_PARTNER.	`"BOARD"`	som ovenfor
handelsregister_roles[].roleobject	Rollenavn til visning, som tekst på de og en.	–	som ovenfor
handelsregister_roles[].start_datestring\|null	Rollens start i formatet YYYY-MM-DD.Tom, når starten ikke er kendt	`"2002-10-15"`	oftest
handelsregister_roles[].end_datestring\|null	Rollens afslutning.Tom, når rollen stadig består	`"2015-07-28"`	altid
affiliationsarray	De virksomheder, personen er forbundet med, hver med forbindelsens art. Opsummeret fra register- og webkilder.	–	som ovenfor
affiliations[].organizationstring	Virksomhedens navn.	`"ENSoXX Holding AG"`	som ovenfor
affiliations[].relationstring	Forbindelsens art som tysk tekst, f.eks. Geschäftsführer (direktør), Prokura eller Kommanditist (kommanditist).	`"Vorstandsmitglied"`	som ovenfor

Webresearch

Den korte bio, ekspertiseområder, kontaktkanaler og kilder samler vi fra offentlige webkilder. Hvor meget der findes, afhænger af, hvor synlig personen er på nettet.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
biostring\|null	Kort bio om personen i en eller to sætninger, på tysk.Tom, når nettet har for lidt om personen (så null)Personprofil	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	oftest
expertisearray	Personens ekspertiseområder og emner som liste.Tom, når nettet har for lidt om personen	–	som ovenfor
contactobject	Offentligt angivne kontaktkanaler, med emails og phones.	–	altid
contact.emailsarray	E-mailadresser som liste.Tom, når der ikke blev fundet nogen adresse	–	sjældent
contact.emails[].addressstring	E-mailadressen.	`"[email protected]"`	som ovenfor
contact.emails[].typestring	Adressens art. organization betyder: en adresse hos virksomheden, ikke en privat.	`"organization"`	som ovenfor
contact.emails[].labelstring	Hvad adressen er til, som kort tekst.	`"Allgemeine Unternehmenskontakt-E-Mail"`	som ovenfor
contact.phonesarray	Telefonnumre som liste.Tom, når der ikke blev fundet noget nummer	–	som ovenfor
contact.phones[].numberstring	Nummeret, som regel i internationalt format.	`"+49374574447100"`	som ovenfor
contact.phones[].typestring	Nummerets art. organization betyder: et nummer hos virksomheden.	`"organization"`	som ovenfor
contact.phones[].entitystring	Den virksomhed, nummeret hører til.	`"Hetzner Online GmbH"`	som ovenfor
contact.phones[].labelstring	Hvad nummeret er til, f.eks. omstilling eller fax.	`"Öffentliche Unternehmens-Telefonnummer"`	som ovenfor
profilesobject	Websider om personen, med linkedin og other.	–	altid
profiles.linkedinstring\|null	Adressen på LinkedIn-profilen.Tom, når der ikke blev fundet nogen	`null`	sjældent
profiles.otherarray	Andre sider om personen, f.eks. presseartikler eller teamsider, som liste af adresser.Tom, når der ikke blev fundet nogen	–	oftest

En AI sammenstiller disse oplysninger fra offentlige kilder. Vi bruger den nyeste teknologi til det og investerer meget i kvalitet; enkelte fejl er stadig mulige.

Kapitalandele og netværk

To features udvider personprofilen: shareholdings viser de virksomheder, personen har andele i. network viser de virksomheder og personer, personen er forbundet med, over to niveauer. Begge afregnes kun, hvis de returnerer data.

Felt
Felt	Betydning	Eksempel	Tilgængelighed
shareholdingsobject\|null	Virksomheder, personen har andele i i dag.Tom, når der ikke kendes nogen ejerandel`shareholdings`	–	delvist
shareholdings.holdings.currentarray	De nuværende ejerandele som liste.	–	som ovenfor
shareholdings.holdings.current[].organizationobject	Virksomheden med entity_id, name, status, legal_form, address og registration, struktureret som i stamdataene.	–	som ovenfor
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel af kapitalen i procent, f.eks. 33.33.	`100`	som ovenfor
shareholdings.holdings.current[].ownership.contributionobject\|null	Ejerandelens pålydende med amount og currency.	–	som ovenfor
shareholdings.holdings.current[].as_ofstring\|null	Oplysningens dato i formatet YYYY-MM-DD.	`"2025-01-13"`	som ovenfor
shareholdings.summary.total_currentinteger	Antal nuværende ejerandele.	`3`	som ovenfor
networkobject\|null	Virksomheder og personer, personen er forbundet med, over to niveauer. Struktureret som network i virksomhedsprofilen.`network` · fra Pro · Beta	–	oftest
network.depthinteger	Hvor mange niveauer netværket omfatter, regnet fra personen. Personen selv er niveau 0.	`2`	som ovenfor
network.nodesarray	Knuderne: personer (PERSON) og virksomheder (ORGANIZATION) med entity_id, name og deres niveau. Personen selv har is_root true.	–	som ovenfor
network.connectionsarray	Forbindelserne mellem to knuder, hver med kind (ROLE, OWNERSHIP eller GROUP), label, periode og is_current.	–	som ovenfor

Videre

fetch-organization Endpointet med featuren related_persons og Realtid. fetch-person Hent personprofilen: parametre, omkostninger og fejl. Find direktører og ejere Trin for trin fra virksomheden til dens personer. Ejere og ejerandele Hvem der ejer en virksomhed, og hvad den har andele i.