handelsregister.ai
Login Signup
Documentation People and representation

People and representation

Who manages and represents a company.

The register names a company’s people: managing directors, management board, Prokura holders, owners, partners and the partners of a KG or OHG. The company profile returns them with the feature related_persons (Management). You get current and former people, each with role, period and power of representation.

For a single person, the person profile returns more: all their roles in other companies, their shareholdings and web research.

Fetch people

Request the feature related_persons. The response then contains the key related_persons with two lists: current for everyone who holds their role today, and past for everyone who has left. Each role is its own entry. In our example request for Hetzner Online GmbH, Ansbach HRB 6089, current held three managing directors. Two of them appeared again in past with their former Prokura. All personal data in the example responses is sample data. 

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'
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 · Example response: Hetzner Online GmbH with the feature related_persons, shortened to name and people
Field
Field Meaning Example Availability
related_personsobject|null All registered people of the company, split into current and past.related_persons – always
related_persons.currentarray People who hold their role today. – as above
related_persons.pastarray People who have left, with the same fields as current. In the two representation rules, latest replaces current: the last version before they left.Empty when nobody has left since registration – mostly

Fields of a person

Every entry in current and past has the same fields. Without Realtime, a person has the same entity_id in all company profiles and in the person profile. This lets you recognize them across companies. People from a Realtime query have their own IDs.

Field
Field Meaning Example Availability
related_persons.current[].entity_idstring|null ID of the person. Without Realtime, it is the same in all company profiles and matches the entity_id in the person profile.related_persons "ea3a1670232611a992727ed067216d07" always
related_persons.current[].labelstring Role as a fixed value. Other values are possible.Values: MANAGING_DIRECTOR managing director (Geschäftsführer), TEMPORARY_MANAGING_DIRECTOR emergency managing director (Notgeschäftsführer), BOARD member of the management board (Vorstand), BOARD_CHAIR chair of the management board, DIRECTOR executive director, for example of an SE, PROCURA Prokura holder (Prokurist), LIQUIDATOR liquidator, INSOLVENCY_ADMINISTRATOR insolvency administrator, REPRESENTATIVE permanent representative, FULLY_LIABLE_PARTNER general partner (persönlich haftender Gesellschafter), LIMITED_PARTNER limited partner (Kommanditist), PARTNER partner, OWNER owner (Inhaber), PROPRIETOR owner (Inhaber), TREASURER treasurer of an association, SECRETARY secretary of an association, YOUTH_WARDEN youth warden of an association, WATER_WARDEN water warden of an association, OTHER other role "MANAGING_DIRECTOR" as above
related_persons.current[].roleobject Role name for display, in de and en, each long (long) and short (short), for example Geschäftsführer and GF. – as above
related_persons.current[].namestring Full name as it appears in the register. "Paul Musterwald" as above
related_persons.current[].name_partsobject The name split into its parts, for sorting and matching. – as above
related_persons.current[].name_parts.givenstring|null Given name, all of them if there are several. "Paul" as above
related_persons.current[].name_parts.familystring|null Family name. "Musterwald" as above
related_persons.current[].name_parts.canonical_namestring|null The name, usually in the form “Family name, Given name”, for sorting and matching. "Musterwald, Paul" as above
related_persons.current[].name_parts.maidenstring|null Birth name.Empty when none is registered null rarely
related_persons.current[].name_parts.previous_namesarray|null Previous names of the person as a list.Empty when none are registered null as above
related_persons.current[].titlesarray Academic titles, for example Dr. The key is missing if no title is registered. – as above
related_persons.current[].birth_datestring|null Date of birth in the format YYYY-MM-DD, as registered.Empty when no date is registered "1989-07-18" mostly
related_persons.current[].locationobject|null Places of the person. – as above
related_persons.current[].location.home.citystring|null Place of residence, as registered. The register contains no full address.Empty when no place of residence is registered "Exempelingen i. Bay." as above
related_persons.current[].start_datestring|null Start of the role in the format YYYY-MM-DD.Empty when the start is not known, for example with Realtime "2019-01-04" as above
related_persons.current[].end_datestring|null End of the role. It is set for people in past.Empty when the role still exists null always

Managing directors and management board

The managing directors (Geschäftsführer) of a GmbH or UG have the label MANAGING_DIRECTOR. You recognize the management board (Vorstand) of an AG, SE or eG by BOARD, its chair by BOARD_CHAIR. When a company is dissolved, liquidators with LIQUIDATOR take over representation.

Always check roles by label. The texts in role are meant for display.

Prokura

Prokura is the registered power of attorney to represent the company in almost all business. Prokura holders (Prokuristen) have the label PROCURA. Whether someone may act alone or only jointly with others is in role_representation_scheme, for example “Gesamtprokura gemeinsam mit einem Vorstandsmitglied” (joint Prokura together with a board member).

General partners

In a KG, OHG and KGaA, the general partners (persönlich haftende Gesellschafter) represent the company. They have the label FULLY_LIABLE_PARTNER. Limited partners (Kommanditisten) of a KG are in the register with LIMITED_PARTNER, the owner of an e.K. with OWNER, the partners of a PartG or eGbR with PARTNER.

In a GmbH & Co. KG, the general partner is usually a GmbH itself. You find its managing directors in that GmbH’s company profile.

Roles by legal form

Which roles a company has follows from its legal form. The table shows which labels you typically see per legal form. All labels with their meaning are listed above under label.

Legal form
Legal form Typical labels
GmbH, UG MANAGING_DIRECTOR, PROCURA, in liquidation LIQUIDATOR
AG, SE BOARD, BOARD_CHAIR, PROCURA
KGaA FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG LIMITED_PARTNER, PROCURA
KG, OHG FULLY_LIABLE_PARTNER, for a KG LIMITED_PARTNER, PROCURA
e.K. OWNER
eG BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR PARTNER
e.V. BOARD

Power of representation

Every person comes with two sets of rules. role_representation_scheme is their own authority, for example “einzelvertretungsberechtigt” (may represent alone). organization_representation_scheme is the company’s general rule, the same as representation_scheme in the core data. Both have current and history; for former people, latest replaces current.

Field
Field Meaning Example Availability
related_persons.current[].role_representation_schemeobject The person’s own power of representation, for example “einzelvertretungsberechtigt” (may represent alone) or an exemption from § 181 BGB. current is the version in force, history the changes with value, effective_from and effective_to.related_persons – mostly: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG
rarely: e.K.
related_persons.current[].organization_representation_schemeobject The company’s general representation rules, included with every person. Structured like role_representation_scheme. – always: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG
mostly: AG, SE, KGaA, e.K.

People with Realtime

With realtime_mode=handelsregister-default, the people currently registered come straight from the Handelsregister, even without the feature related_persons. Only Realtime is charged then, not the feature. The response contains only current.

In this list, start_date and end_date are empty, names can be shorter, and a person’s entity_id can differ from the one without Realtime. Match people by name and date of birth.

If you request Realtime and related_persons together, current comes from the live query and past from the company profile. Then the feature is charged too.

Field
Field Meaning Example Availability
related_persons.current[].name_parts.aliasesarray Spellings of the name from the live query, in the form “Family name, Given name”. Only with Realtime.related_persons – always

Person profile

The person profile (fetch-person) describes a single person: their roles in all companies they are connected to, and what public web sources say about them. You find the person by their name and a company in which they hold or held a role.

The person profile comes with every credit subscription from Plus. A request often takes ten to thirty seconds, because we research the web. Set your client’s timeout to at least 120 seconds. 

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'
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 · Example response: person profile of Max Felix Mustermann (sample data) at Hetzner Online GmbH, shortened

The person

Name, date of birth and place of residence come from the register. The entity_id is the same as in related_persons of the company profiles without Realtime.

Field
Field Meaning Example Availability
entity_idstring ID of the person. The same ID appears in related_persons of the company profiles without Realtime.Person profile "08ed5f967956831ca6588930fd2693ed" always
namestring Full name as it appears in the register. "Max Felix Mustermann" as above
birth_datestring|null Date of birth in the format YYYY-MM-DD, as registered.Empty when no date is registered "1976-01-15" mostly
name_partsobject The name split into its parts, structured like in related_persons. – always
name_parts.givenstring|null Given name, all of them if there are several. "Max Felix" as above
name_parts.familystring|null Family name. "Mustermann" as above
name_parts.canonical_namestring|null The name, usually in the form “Family name, Given name”, for sorting and matching. "Mustermann, Max Felix" as above
name_parts.maidenstring|null Birth name.Empty when none is registered null rarely
name_parts.previous_namesarray|null Previous names of the person as a list.Empty when none are registered null as above
locationobject Places of the person. – mostly
location.home.citystring|null Place of residence, as registered.Empty when no place of residence is registered "Musterheim" as above

Roles and connections

handelsregister_roles lists every registered role of the person with the company and its period. Use a company’s entity_id to fetch its company profile. affiliations sums up the connections briefly, from register and web.

Field
Field Meaning Example Availability
handelsregister_rolesarray The person’s registered roles with company and period, current and former.Person profile – always
handelsregister_roles[].entity_idstring entity_id of the company, for a company profile in the parameter q. "0b3435f83ce8591300625100815d4583" as above
handelsregister_roles[].namestring Name of the company. "Hetzner Online GmbH" as above
handelsregister_roles[].labelstring Role as a fixed value, the same values as label in related_persons, for example MANAGING_DIRECTOR, BOARD, PROCURA or LIMITED_PARTNER. "BOARD" as above
handelsregister_roles[].roleobject Role name for display, as text in de and en. – as above
handelsregister_roles[].start_datestring|null Start of the role in the format YYYY-MM-DD.Empty when the start is not known "2002-10-15" mostly
handelsregister_roles[].end_datestring|null End of the role.Empty when the role still exists "2015-07-28" always
affiliationsarray The companies the person is connected to, each with the kind of connection. Summed up from register and web sources. – as above
affiliations[].organizationstring Name of the company. "ENSoXX Holding AG" as above
affiliations[].relationstring Kind of connection as German text, for example Geschäftsführer (managing director), Prokura or Kommanditist (limited partner). "Vorstandsmitglied" as above

Web research

We collect the short bio, areas of expertise, contact channels and sources from public web sources. How much of it exists depends on how visible the person is on the web.

Field
Field Meaning Example Availability
biostring|null Short bio of the person in one or two sentences, in German.Empty when the web has too little about the person (then null)Person profile "Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…" mostly
expertisearray Areas of expertise and topics of the person as a list.Empty when the web has too little about the person – as above
contactobject Publicly listed contact channels, with emails and phones. – always
contact.emailsarray Email addresses as a list.Empty when no address was found – rarely
contact.emails[].addressstring The email address. "[email protected]" as above
contact.emails[].typestring Kind of address. organization means: an address of the company, not a private one. "organization" as above
contact.emails[].labelstring What the address is for, as a short text. "Allgemeine Unternehmenskontakt-E-Mail" as above
contact.phonesarray Phone numbers as a list.Empty when no number was found – as above
contact.phones[].numberstring The number, usually in international format. "+49374574447100" as above
contact.phones[].typestring Kind of number. organization means: a number of the company. "organization" as above
contact.phones[].entitystring The company the number belongs to. "Hetzner Online GmbH" as above
contact.phones[].labelstring What the number is for, for example switchboard or fax. "Öffentliche Unternehmens-Telefonnummer" as above
profilesobject Web pages about the person, with linkedin and other. – always
profiles.linkedinstring|null Address of the LinkedIn profile.Empty when none was found null rarely
profiles.otherarray Other pages about the person, for example press articles or team pages, as a list of addresses.Empty when none were found – mostly
An AI compiles this information from public sources. We use the latest technology for this and invest a lot in quality; individual errors are still possible.

Shareholdings and network

Two features extend the person profile: shareholdings shows the companies the person holds stakes in. network shows the companies and people they are connected to, across two levels. Both are only charged if they return data.

Field
Field Meaning Example Availability
shareholdingsobject|null Companies the person holds stakes in today.Empty when no shareholding is knownshareholdings – partly
shareholdings.holdings.currentarray The current shareholdings as a list. – as above
shareholdings.holdings.current[].organizationobject The company with entity_id, name, status, legal_form, address and registration, structured like in the core data. – as above
shareholdings.holdings.current[].ownership.percentagenumber|null Share of the capital in percent, for example 33.33. 100 as above
shareholdings.holdings.current[].ownership.contributionobject|null Nominal amount of the shareholding with amount and currency. – as above
shareholdings.holdings.current[].as_ofstring|null Date of the information in the format YYYY-MM-DD. "2025-01-13" as above
shareholdings.summary.total_currentinteger Number of current shareholdings. 3 as above
networkobject|null Companies and people the person is connected to, across two levels. Structured like network in the company profile.network · from Pro · Beta – mostly
network.depthinteger How many levels the network covers, counted from the person. The person itself is level 0. 2 as above
network.nodesarray The nodes: people (PERSON) and companies (ORGANIZATION) with entity_id, name and their level. The person themselves has is_root true. – as above
network.connectionsarray The connections between two nodes, each with kind (ROLE, OWNERSHIP or GROUP), label, period and is_current. – as above

Next

fetch-organization The endpoint with the feature related_persons and Realtime. fetch-person Fetch the person profile: parameters, costs and errors. Find managing directors and shareholders Step by step from the company to its people. Shareholders and shareholdings Who owns a company and what it holds stakes in.