Personer och företrädare – Dokumentation

Hämta personer

Begär funktionen related_persons. Svaret innehåller då nyckeln related_persons med två listor: current för alla som har sin roll i dag, och past för alla som har lämnat. Varje roll är en egen post. I vår exempelförfrågan för Hetzner Online GmbH, Ansbach HRB 6089, innehöll current tre verkställande direktörer. Två av dem förekom igen i past med sin tidigare Prokura. Alla personuppgifter i exempelsvaren är exempeldata.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DIN_API_NYCKEL" \
  --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_NYCKEL"},
    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_NYCKEL" },
});
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 · Exempelsvar: Hetzner Online GmbH med funktionen related_persons, förkortat till namn och personer

Fält
Fält	Betydelse	Exempel	Tillgänglighet
related_personsobject\|null	Alla registrerade personer i företaget, uppdelade i current och past.`related_persons`	–	alltid
related_persons.currentarray	Personer som har sin roll i dag.	–	som ovan
related_persons.pastarray	Personer som har lämnat, med samma fält som current. I de två företrädarreglerna ersätter latest current: den sista versionen innan personen lämnade.Tomt när ingen har lämnat sedan registreringen	–	oftast

Fält för en person

Varje post i current och past har samma fält. Utan Realtid har en person samma entity_id i alla företagsprofiler och i personprofilen. Därmed känner du igen personen över företag. Personer från en fråga med Realtid har egna ID:n.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
related_persons.current[].entity_idstring\|null	Personens ID. Utan Realtid är det detsamma i alla företagsprofiler och motsvarar entity_id i personprofilen.`related_persons`	`"ea3a1670232611a992727ed067216d07"`	alltid
related_persons.current[].labelstring	Roll som fast värde. Andra värden är möjliga.Värden: `MANAGING_DIRECTOR` verkställande direktör (Geschäftsführer), `TEMPORARY_MANAGING_DIRECTOR` tillfälligt förordnad verkställande direktör (Notgeschäftsführer), `BOARD` styrelseledamot i ledningsorganet (Vorstand), `BOARD_CHAIR` ordförande i ledningsorganet, `DIRECTOR` verkställande direktör, till exempel för ett SE, `PROCURA` innehavare av Prokura (Prokurist), `LIQUIDATOR` likvidator, `INSOLVENCY_ADMINISTRATOR` insolvensförvaltare, `REPRESENTATIVE` ständig företrädare, `FULLY_LIABLE_PARTNER` personligt ansvarig bolagsman (persönlich haftender Gesellschafter), `LIMITED_PARTNER` kommanditdelägare (Kommanditist), `PARTNER` partner, `OWNER` ägare (Inhaber), `PROPRIETOR` ägare (Inhaber), `TREASURER` kassör i en förening, `SECRETARY` sekreterare i en förening, `YOUTH_WARDEN` ungdomsansvarig i en förening, `WATER_WARDEN` vattenansvarig i en förening, `OTHER` annan roll	`"MANAGING_DIRECTOR"`	som ovan
related_persons.current[].roleobject	Rollnamn för visning, på de och en, vardera långt (long) och kort (short), till exempel Geschäftsführer och GF.	–	som ovan
related_persons.current[].namestring	Fullständigt namn så som det står i registret.	`"Paul Musterwald"`	som ovan
related_persons.current[].name_partsobject	Namnet uppdelat i sina delar, för sortering och matchning.	–	som ovan
related_persons.current[].name_parts.givenstring\|null	Förnamn, alla om det finns flera.	`"Paul"`	som ovan
related_persons.current[].name_parts.familystring\|null	Efternamn.	`"Musterwald"`	som ovan
related_persons.current[].name_parts.canonical_namestring\|null	Namnet, oftast i formen ”Efternamn, Förnamn”, för sortering och matchning.	`"Musterwald, Paul"`	som ovan
related_persons.current[].name_parts.maidenstring\|null	Födelsenamn.Tomt när inget är registrerat	`null`	sällan
related_persons.current[].name_parts.previous_namesarray\|null	Personens tidigare namn som lista.Tomt när inga är registrerade	`null`	som ovan
related_persons.current[].titlesarray	Akademiska titlar, till exempel Dr. Nyckeln saknas om ingen titel är registrerad.	–	som ovan
related_persons.current[].birth_datestring\|null	Födelsedatum i formatet YYYY-MM-DD, så som det är registrerat.Tomt när inget datum är registrerat	`"1989-07-18"`	oftast
related_persons.current[].locationobject\|null	Personens orter.	–	som ovan
related_persons.current[].location.home.citystring\|null	Bostadsort, så som den är registrerad. Registret innehåller ingen fullständig adress.Tomt när ingen bostadsort är registrerad	`"Exempelingen i. Bay."`	som ovan
related_persons.current[].start_datestring\|null	Rollens början i formatet YYYY-MM-DD.Tomt när början inte är känd, till exempel med Realtid	`"2019-01-04"`	som ovan
related_persons.current[].end_datestring\|null	Rollens slut. Det är satt för personer i past.Tomt när rollen fortfarande består	`null`	alltid

Verkställande direktörer och styrelse

De verkställande direktörerna (Geschäftsführer) för en GmbH eller UG har etiketten MANAGING_DIRECTOR. Styrelsen (Vorstand) för ett AG, SE eller eG känner du igen på BOARD, dess ordförande på BOARD_CHAIR. När ett företag upplöses tar likvidatorer med LIQUIDATOR över företrädandet.

Kontrollera alltid roller via label. Texterna i role är avsedda för visning.

Prokura

Prokura är den registrerade fullmakten att företräda företaget i nästan alla affärer. Innehavare av Prokura (Prokuristen) har etiketten PROCURA. Om någon får agera ensam eller bara tillsammans med andra står i role_representation_scheme, till exempel ”Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (gemensam Prokura tillsammans med en styrelseledamot).

Komplementärer

I ett KG, OHG och KGaA företräds företaget av de personligt ansvariga bolagsmännen (persönlich haftende Gesellschafter). De har etiketten FULLY_LIABLE_PARTNER. Kommanditdelägare (Kommanditisten) i ett KG står i registret med LIMITED_PARTNER, ägaren till en e.K. med OWNER, partnerna i ett PartG eller eGbR med PARTNER.

I ett GmbH & Co. KG är komplementären oftast själv en GmbH. Dess verkställande direktörer hittar du i den GmbH:ns företagsprofil.

Roller per bolagsform

Vilka roller ett företag har följer av dess bolagsform. Tabellen visar vilka etiketter du typiskt ser per bolagsform. Alla etiketter med betydelse finns ovan under label.

Bolagsform
Bolagsform	Typiska etiketter
GmbH, UG	MANAGING_DIRECTOR, PROCURA, vid likvidation LIQUIDATOR
AG, SE	BOARD, BOARD_CHAIR, PROCURA
KGaA	FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG	LIMITED_PARTNER, PROCURA
KG, OHG	FULLY_LIABLE_PARTNER, för ett KG LIMITED_PARTNER, PROCURA
e.K.	OWNER
eG	BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR	PARTNER
e.V.	BOARD

Företrädarbehörighet

Varje person kommer med två regeluppsättningar. role_representation_scheme är personens egen behörighet, till exempel ”einzelvertretungsberechtigt” (får företräda ensam). organization_representation_scheme är företagets allmänna regel, densamma som representation_scheme i basdata. Båda har current och history; för tidigare personer ersätter latest current.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
related_persons.current[].role_representation_schemeobject	Personens egen företrädarbehörighet, till exempel ”einzelvertretungsberechtigt” (får företräda ensam) eller en befrielse från § 181 BGB. current är den gällande versionen, history ändringarna med value, effective_from och effective_to.`related_persons`	–	oftast: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG sällan: e.K.
related_persons.current[].organization_representation_schemeobject	Företagets allmänna företrädarregler, medskickade för varje person. Uppbyggda som role_representation_scheme.	–	alltid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG oftast: AG, SE, KGaA, e.K.

Personer med Realtid

Med realtime_mode=handelsregister-default kommer de personer som är registrerade just nu direkt från Handelsregister, även utan funktionen related_persons. Då debiteras bara Realtid, inte funktionen. Svaret innehåller bara current.

I denna lista är start_date och end_date tomma, namn kan vara kortare, och en persons entity_id kan skilja sig från det utan Realtid. Matcha personer via namn och födelsedatum.

Om du begär Realtid och related_persons tillsammans kommer current från live-frågan och past från företagsprofilen. Då debiteras även funktionen.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
related_persons.current[].name_parts.aliasesarray	Stavningar av namnet från live-frågan, i formen ”Efternamn, Förnamn”. Bara med Realtid.`related_persons`	–	alltid

Personprofil

Personprofilen (fetch-person) beskriver en enskild person: personens roller i alla företag som personen är kopplad till, och vad offentliga webbkällor säger om personen. Du hittar personen via namn och ett företag där personen har eller hade en roll.

Personprofilen ingår i varje kreditprenumeration från och med Plus. En förfrågan tar ofta tio till trettio sekunder, eftersom vi researchar på webben. Ställ in din klients timeout på minst 120 sekunder.

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: DIN_API_NYCKEL" \
  --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_NYCKEL"},
    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_NYCKEL" },
});
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 · Exempelsvar: personprofil för Max Felix Mustermann (exempeldata) hos Hetzner Online GmbH, förkortad

Personen

Namn, födelsedatum och bostadsort kommer från registret. entity_id är detsamma som i related_persons i företagsprofilerna utan Realtid.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
entity_idstring	Personens ID. Samma ID förekommer i related_persons i företagsprofilerna utan Realtid.Personprofil	`"08ed5f967956831ca6588930fd2693ed"`	alltid
namestring	Fullständigt namn så som det står i registret.	`"Max Felix Mustermann"`	som ovan
birth_datestring\|null	Födelsedatum i formatet YYYY-MM-DD, så som det är registrerat.Tomt när inget datum är registrerat	`"1976-01-15"`	oftast
name_partsobject	Namnet uppdelat i sina delar, uppbyggt som i related_persons.	–	alltid
name_parts.givenstring\|null	Förnamn, alla om det finns flera.	`"Max Felix"`	som ovan
name_parts.familystring\|null	Efternamn.	`"Mustermann"`	som ovan
name_parts.canonical_namestring\|null	Namnet, oftast i formen ”Efternamn, Förnamn”, för sortering och matchning.	`"Mustermann, Max Felix"`	som ovan
name_parts.maidenstring\|null	Födelsenamn.Tomt när inget är registrerat	`null`	sällan
name_parts.previous_namesarray\|null	Personens tidigare namn som lista.Tomt när inga är registrerade	`null`	som ovan
locationobject	Personens orter.	–	oftast
location.home.citystring\|null	Bostadsort, så som den är registrerad.Tomt när ingen bostadsort är registrerad	`"Musterheim"`	som ovan

Roller och kopplingar

handelsregister_roles listar varje registrerad roll som personen har, med företaget och perioden. Med ett företags entity_id hämtar du dess företagsprofil. affiliations sammanfattar kopplingarna kort, från register och webb.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
handelsregister_rolesarray	Personens registrerade roller med företag och period, nuvarande och tidigare.Personprofil	–	alltid
handelsregister_roles[].entity_idstring	Företagets entity_id, för en företagsprofil i parametern q.	`"0b3435f83ce8591300625100815d4583"`	som ovan
handelsregister_roles[].namestring	Företagets namn.	`"Hetzner Online GmbH"`	som ovan
handelsregister_roles[].labelstring	Roll som fast värde, samma värden som label i related_persons, till exempel MANAGING_DIRECTOR, BOARD, PROCURA eller LIMITED_PARTNER.	`"BOARD"`	som ovan
handelsregister_roles[].roleobject	Rollnamn för visning, som text på de och en.	–	som ovan
handelsregister_roles[].start_datestring\|null	Rollens början i formatet YYYY-MM-DD.Tomt när början inte är känd	`"2002-10-15"`	oftast
handelsregister_roles[].end_datestring\|null	Rollens slut.Tomt när rollen fortfarande består	`"2015-07-28"`	alltid
affiliationsarray	De företag som personen är kopplad till, vart och ett med typen av koppling. Sammanfattat från register- och webbkällor.	–	som ovan
affiliations[].organizationstring	Företagets namn.	`"ENSoXX Holding AG"`	som ovan
affiliations[].relationstring	Typ av koppling som tysk text, till exempel Geschäftsführer (verkställande direktör), Prokura eller Kommanditist (kommanditdelägare).	`"Vorstandsmitglied"`	som ovan

Webbresearch

Den korta presentationen, kompetensområden, kontaktvägar och källor samlar vi in från offentliga webbkällor. Hur mycket som finns beror på hur synlig personen är på webben.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
biostring\|null	Kort presentation av personen i en eller två meningar, på tyska.Tomt när webben har för lite om personen (då null)Personprofil	`"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…"`	oftast
expertisearray	Personens kompetensområden och ämnen som lista.Tomt när webben har för lite om personen	–	som ovan
contactobject	Offentligt angivna kontaktvägar, med emails och phones.	–	alltid
contact.emailsarray	E-postadresser som lista.Tomt när ingen adress hittades	–	sällan
contact.emails[].addressstring	E-postadressen.	`"[email protected]"`	som ovan
contact.emails[].typestring	Typ av adress. organization betyder: en adress till företaget, inte en privat.	`"organization"`	som ovan
contact.emails[].labelstring	Vad adressen är till för, som kort text.	`"Allgemeine Unternehmenskontakt-E-Mail"`	som ovan
contact.phonesarray	Telefonnummer som lista.Tomt när inget nummer hittades	–	som ovan
contact.phones[].numberstring	Numret, oftast i internationellt format.	`"+49374574447100"`	som ovan
contact.phones[].typestring	Typ av nummer. organization betyder: ett nummer till företaget.	`"organization"`	som ovan
contact.phones[].entitystring	Det företag som numret hör till.	`"Hetzner Online GmbH"`	som ovan
contact.phones[].labelstring	Vad numret är till för, till exempel växel eller fax.	`"Öffentliche Unternehmens-Telefonnummer"`	som ovan
profilesobject	Webbsidor om personen, med linkedin och other.	–	alltid
profiles.linkedinstring\|null	Adress till LinkedIn-profilen.Tomt när ingen hittades	`null`	sällan
profiles.otherarray	Andra sidor om personen, till exempel pressartiklar eller teamsidor, som lista med adresser.Tomt när inga hittades	–	oftast

En AI sammanställer denna information ur offentliga källor. Vi använder den senaste tekniken för detta och investerar mycket i kvalitet; enskilda fel är ändå möjliga.

Delägarskap och nätverk

Två funktioner utökar personprofilen: shareholdings visar de företag som personen äger andelar i. network visar de företag och personer som personen är kopplad till, över två nivåer. Båda debiteras bara om de returnerar data.

Fält
Fält	Betydelse	Exempel	Tillgänglighet
shareholdingsobject\|null	Företag som personen äger andelar i i dag.Tomt när inget delägarskap är känt`shareholdings`	–	delvis
shareholdings.holdings.currentarray	De nuvarande delägarskapen som lista.	–	som ovan
shareholdings.holdings.current[].organizationobject	Företaget med entity_id, name, status, legal_form, address och registration, uppbyggt som i basdata.	–	som ovan
shareholdings.holdings.current[].ownership.percentagenumber\|null	Andel av kapitalet i procent, till exempel 33.33.	`100`	som ovan
shareholdings.holdings.current[].ownership.contributionobject\|null	Delägarskapets nominella belopp med amount och currency.	–	som ovan
shareholdings.holdings.current[].as_ofstring\|null	Uppgiftens datum i formatet YYYY-MM-DD.	`"2025-01-13"`	som ovan
shareholdings.summary.total_currentinteger	Antal nuvarande delägarskap.	`3`	som ovan
networkobject\|null	Företag och personer som personen är kopplad till, över två nivåer. Uppbyggt som network i företagsprofilen.`network` · från Pro · Beta	–	oftast
network.depthinteger	Hur många nivåer nätverket omfattar, räknat från personen. Personen själv är nivå 0.	`2`	som ovan
network.nodesarray	Noderna: personer (PERSON) och företag (ORGANIZATION) med entity_id, namn och sin nivå. Personen själv har is_root true.	–	som ovan
network.connectionsarray	Kopplingarna mellan två noder, var och en med kind (ROLE, OWNERSHIP eller GROUP), label, period och is_current.	–	som ovan

Vidare

fetch-organization Endpointen med funktionen related_persons och Realtid. fetch-person Hämta personprofilen: parametrar, kostnader och fel. Hitta verkställande direktörer och delägare Steg för steg från företaget till dess personer. Delägare och innehav Vem som äger ett företag och vad det äger andelar i.