人员与代表
谁管理并代表公司。
登记册列明公司的相关人员：总经理、董事会、Prokura 持有人、所有人、合伙人以及 KG 或 OHG 的合伙人。公司档案通过功能 related_persons（管理层）返回这些人员。你会得到现任和前任人员，各含职务、期间和代表权。
对单个人员，人物档案提供更多信息：此人在其他公司的所有职务、持股以及网络检索结果。
获取人员
请求功能 related_persons。响应中会包含键 related_persons，内有两个列表：current 列出目前担任职务的所有人，past 列出所有已离任的人。每个职务单独成为一个条目。在我们对 Hetzner Online GmbH（Ansbach HRB 6089）的示例请求中，current 包含三位总经理。其中两位又以其以前的 Prokura 出现在 past 中。示例响应中的所有个人数据均为示例数据。
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'q=Hetzner Online GmbH' \ --data-urlencode 'feature=related_persons'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "YOUR_API_KEY"}, params={ "q": "Hetzner Online GmbH", "feature": ["related_persons"], }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Hetzner Online GmbH"); url.searchParams.append("feature", "related_persons"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();
1{2 "name": "Hetzner Online GmbH",3 "related_persons": {4 "current": [5 {6 "entity_id": "ea3a1670232611a992727ed067216d07",7 "label": "MANAGING_DIRECTOR",8 "role": {9 "en": {10 "long": "Managing Director",11 "short": "MD"12 },13 "de": {14 "long": "Geschäftsführer",15 "short": "GF"16 }17 },18 "name": "Paul Musterwald",19 "start_date": "2019-01-04",20 "end_date": null,21 "birth_date": "1989-07-18",22 "name_parts": {23 "given": "Paul",24 "family": "Musterwald",25 "maiden": null,26 "canonical_name": "Musterwald, Paul",27 "previous_names": null28 },29 "location": {30 "home": {31 "city": "Exempelingen i. Bay."32 }33 },34 "organization_representation_scheme": {35 "current": [36 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."37 ],38 "history": [39 {40 "value": [41 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."42 ],43 "effective_from": "2002-10-15",44 "effective_to": "2015-07-28"45 },46 {47 "value": [48 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."49 ],50 "effective_from": "2015-07-28",51 "effective_to": null52 }53 ]54 },55 "role_representation_scheme": {56 "current": [57 "einzelvertretungsberechtigt."58 ],59 "history": [60 {61 "value": [62 "einzelvertretungsberechtigt."63 ],64 "effective_from": "2019-01-04",65 "effective_to": null66 }67 ]68 }69 },70 {71 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72 "label": "MANAGING_DIRECTOR",73 "role": {74 "en": {75 "long": "Managing Director",76 "short": "MD"77 },78 "de": {79 "long": "Geschäftsführer",80 "short": "GF"81 }82 },83 "name": "Jan Musterhuber",84 "start_date": "2019-01-04",85 "end_date": null,86 "birth_date": "1955-11-06",87 "name_parts": {88 "given": "Jan",89 "family": "Musterhuber",90 "maiden": null,91 "canonical_name": "Musterhuber, Jan",92 "previous_names": null93 },94 "location": {95 "home": {96 "city": "Probeingen"97 }98 },99 "organization_representation_scheme": {100 "current": [101 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102 ],103 "history": [104 {105 "value": [106 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."107 ],108 "effective_from": "2002-10-15",109 "effective_to": "2015-07-28"110 },111 {112 "value": [113 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."114 ],115 "effective_from": "2015-07-28",116 "effective_to": null117 }118 ]119 },120 "role_representation_scheme": {121 "current": [122 "einzelvertretungsberechtigt."123 ],124 "history": [125 {126 "value": [127 "einzelvertretungsberechtigt."128 ],129 "effective_from": "2019-01-04",130 "effective_to": null131 }132 ]133 }134 },135 {136 "entity_id": "08ed5f967956831ca6588930fd2693ed",137 "label": "MANAGING_DIRECTOR",138 "role": {139 "en": {140 "long": "Managing Director",141 "short": "MD"142 },143 "de": {144 "long": "Geschäftsführer",145 "short": "GF"146 }147 },148 "name": "Max Felix Mustermann",149 "start_date": "2015-07-28",150 "end_date": null,151 "birth_date": "1976-01-15",152 "name_parts": {153 "given": "Max Felix",154 "family": "Mustermann",155 "maiden": null,156 "canonical_name": "Mustermann, Max Felix",157 "previous_names": null158 },159 "location": {160 "home": {161 "city": "Musterheim"162 }163 },164 "organization_representation_scheme": {165 "current": [166 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."167 ],168 "history": [169 {170 "value": [171 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."172 ],173 "effective_from": "2002-10-15",174 "effective_to": "2015-07-28"175 },176 {177 "value": [178 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."179 ],180 "effective_from": "2015-07-28",181 "effective_to": null182 }183 ]184 },185 "role_representation_scheme": {186 "current": [187 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188 ],189 "history": [190 {191 "value": [192 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193 ],194 "effective_from": "2015-07-28",195 "effective_to": null196 }197 ]198 }199 }200 ],201 "past": [202 {203 "entity_id": "ea3a1670232611a992727ed067216d07",204 "label": "PROCURA",205 "role": {206 "en": {207 "long": "Procura",208 "short": "Procura"209 },210 "de": {211 "long": "Prokura",212 "short": "Prokura"213 }214 },215 "name": "Paul Musterwald",216 "start_date": "2015-07-28",217 "end_date": "2019-01-04",218 "birth_date": "1989-07-18",219 "name_parts": {220 "given": "Paul",221 "family": "Musterwald",222 "maiden": null,223 "canonical_name": "Musterwald, Paul",224 "previous_names": null225 },226 "location": {227 "home": {228 "city": "Exempelingen i. Bay."229 }230 },231 "organization_representation_scheme": {232 "latest": [233 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."234 ],235 "history": [236 {237 "value": [238 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."239 ],240 "effective_from": "2002-10-15",241 "effective_to": "2015-07-28"242 },243 {244 "value": [245 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."246 ],247 "effective_from": "2015-07-28",248 "effective_to": null249 }250 ]251 },252 "role_representation_scheme": {253 "latest": [254 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255 ],256 "history": [257 {258 "value": [259 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260 ],261 "effective_from": "2015-07-28",262 "effective_to": "2019-01-04"263 }264 ]265 }266 },267 {268 "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269 "label": "PROCURA",270 "role": {271 "en": {272 "long": "Procura",273 "short": "Procura"274 },275 "de": {276 "long": "Prokura",277 "short": "Prokura"278 }279 },280 "name": "Jan Musterhuber",281 "start_date": "2015-07-28",282 "end_date": "2019-01-04",283 "birth_date": "1955-11-06",284 "name_parts": {285 "given": "Jan",286 "family": "Musterhuber",287 "maiden": null,288 "canonical_name": "Musterhuber, Jan",289 "previous_names": null290 },291 "location": {292 "home": {293 "city": "Probeingen"294 }295 },296 "organization_representation_scheme": {297 "latest": [298 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."299 ],300 "history": [301 {302 "value": [303 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."304 ],305 "effective_from": "2002-10-15",306 "effective_to": "2015-07-28"307 },308 {309 "value": [310 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."311 ],312 "effective_from": "2015-07-28",313 "effective_to": null314 }315 ]316 },317 "role_representation_scheme": {318 "latest": [319 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320 ],321 "history": [322 {323 "value": [324 "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325 ],326 "effective_from": "2015-07-28",327 "effective_to": "2019-01-04"328 }329 ]330 }331 },332 {333 "entity_id": "08ed5f967956831ca6588930fd2693ed",334 "label": "BOARD",335 "role": {336 "en": {337 "long": "Board Member",338 "short": "Board"339 },340 "de": {341 "long": "Vorstandsmitglied",342 "short": "Vorstand"343 }344 },345 "name": "Max Felix Mustermann",346 "start_date": "2002-10-15",347 "end_date": "2015-07-28",348 "birth_date": "1976-01-15",349 "name_parts": {350 "given": "Max Felix",351 "family": "Mustermann",352 "maiden": null,353 "canonical_name": "Mustermann, Max Felix",354 "previous_names": null355 },356 "location": {357 "home": {358 "city": "Musterheim"359 }360 },361 "organization_representation_scheme": {362 "latest": [363 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."364 ],365 "history": [366 {367 "value": [368 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."369 ],370 "effective_from": "2002-10-15",371 "effective_to": "2015-07-28"372 },373 {374 "value": [375 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."376 ],377 "effective_from": "2015-07-28",378 "effective_to": null379 }380 ]381 },382 "role_representation_scheme": {383 "latest": [384 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385 ],386 "history": [387 {388 "value": [389 "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390 ],391 "effective_from": "2002-10-15",392 "effective_to": "2015-07-28"393 }394 ]395 }396 }397 ]398 }399}
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| related_personsobject|null |
公司所有已登记的人员，分为 current 和 past。related_persons |
– | 总是 |
| related_persons.currentarray | 目前担任职务的人员。 | – | 同上 |
| related_persons.pastarray | 已离任的人员，字段与 current 相同。在两套代表规则中，latest 代替 current：即离任前的最后版本。为空：自登记以来无人离任 | – | 大多 |
人员的字段
current 和 past 中的每个条目都有相同的字段。不使用实时模式时，同一人员在所有公司档案和人物档案中具有相同的 entity_id。这样你就能跨公司识别此人。来自实时查询的人员有各自的 ID。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| related_persons.current[].entity_idstring|null |
人员的 ID。不使用实时模式时，它在所有公司档案中相同，并与人物档案中的 entity_id 一致。related_persons |
"ea3a1670232611a992727ed067216d07" |
总是 |
| related_persons.current[].labelstring |
职务的固定取值。也可能出现其他取值。取值: MANAGING_DIRECTOR 总经理（Geschäftsführer）, TEMPORARY_MANAGING_DIRECTOR 紧急总经理（Notgeschäftsführer）, BOARD 董事会成员（Vorstand）, BOARD_CHAIR 董事会主席, DIRECTOR 执行董事，例如 SE 的, PROCURA Prokura 持有人（Prokurist）, LIQUIDATOR 清算人, INSOLVENCY_ADMINISTRATOR 破产管理人, REPRESENTATIVE 常任代表, FULLY_LIABLE_PARTNER 无限责任合伙人（persönlich haftender Gesellschafter）, LIMITED_PARTNER 有限合伙人（Kommanditist）, PARTNER 合伙人, OWNER 所有人（Inhaber）, PROPRIETOR 所有人（Inhaber）, TREASURER 社团的财务主管, SECRETARY 社团的秘书, YOUTH_WARDEN 社团的青少年负责人, WATER_WARDEN 社团的水域管理员, OTHER 其他角色 |
"MANAGING_DIRECTOR" |
同上 |
| related_persons.current[].roleobject | 用于显示的职务名称，de 和 en，各有长名（long）和短名（short），例如 Geschäftsführer 和 GF。 | – | 同上 |
| related_persons.current[].namestring | 登记册中的全名。 |
"Paul Musterwald" |
同上 |
| related_persons.current[].name_partsobject | 拆分为各部分的姓名，用于排序和匹配。 | – | 同上 |
| related_persons.current[].name_parts.givenstring|null | 名；有多个时全部列出。 |
"Paul" |
同上 |
| related_persons.current[].name_parts.familystring|null | 姓。 |
"Musterwald" |
同上 |
| related_persons.current[].name_parts.canonical_namestring|null | 姓名，通常为“姓, 名”的形式，用于排序和匹配。 |
"Musterwald, Paul" |
同上 |
| related_persons.current[].name_parts.maidenstring|null | 出生时的姓。为空：未登记 |
null |
很少 |
| related_persons.current[].name_parts.previous_namesarray|null | 此人以前的姓名列表。为空：未登记 |
null |
同上 |
| related_persons.current[].titlesarray | 学术头衔，例如 Dr.。未登记头衔时该键不存在。 | – | 同上 |
| related_persons.current[].birth_datestring|null | 出生日期，格式为 YYYY-MM-DD，以登记为准。为空：未登记日期 |
"1989-07-18" |
大多 |
| related_persons.current[].locationobject|null | 此人的地点。 | – | 同上 |
| related_persons.current[].location.home.citystring|null | 居住地，以登记为准。登记册不包含完整地址。为空：未登记居住地 |
"Exempelingen i. Bay." |
同上 |
| related_persons.current[].start_datestring|null | 职务开始日期，格式为 YYYY-MM-DD。为空：开始日期未知，例如使用实时模式时 |
"2019-01-04" |
同上 |
| related_persons.current[].end_datestring|null | 职务结束日期。past 中的人员有此值。为空：职务仍然存在 |
null |
总是 |
总经理和董事会
GmbH 或 UG 的总经理（Geschäftsführer）的 label 为 MANAGING_DIRECTOR。AG、SE 或 eG 的董事会（Vorstand）以 BOARD 标识，其主席以 BOARD_CHAIR 标识。公司解散后，由 label 为 LIQUIDATOR 的清算人接管代表权。
请始终通过
label 判断职务。role 中的文本用于显示。
Prokura
Prokura 是经登记的商业代理权，可在几乎所有业务中代表公司。Prokura 持有人（Prokuristen）的 label 为 PROCURA。某人可以单独行事还是只能与他人共同行事，见 role_representation_scheme，例如“Gesamtprokura gemeinsam mit einem Vorstandsmitglied”（与一名董事会成员共同行使的共同 Prokura）。
无限责任合伙人
在 KG、OHG 和 KGaA 中，由无限责任合伙人（persönlich haftende Gesellschafter）代表公司。其 label 为 FULLY_LIABLE_PARTNER。KG 的有限合伙人（Kommanditisten）在登记册中为 LIMITED_PARTNER，e.K. 的所有人为 OWNER，PartG 或 eGbR 的合伙人为 PARTNER。
在 GmbH & Co. KG 中，无限责任合伙人通常本身就是一家 GmbH。其总经理可在该 GmbH 的公司档案中找到。
按法律形式划分的职务
公司有哪些职务取决于其法律形式。下表列出每种法律形式通常出现的 label。所有 label 及其含义见上文 label。
| 法律形式 | 常见 label |
|---|---|
| GmbH, UG | MANAGING_DIRECTOR、PROCURA，清算中为 LIQUIDATOR |
| AG, SE | BOARD、BOARD_CHAIR、PROCURA |
| KGaA | FULLY_LIABLE_PARTNER、PROCURA |
| GmbH & Co. KG | LIMITED_PARTNER、PROCURA |
| KG, OHG | FULLY_LIABLE_PARTNER，KG 还有 LIMITED_PARTNER，PROCURA |
| e.K. | OWNER |
| eG | BOARD、BOARD_CHAIR、PROCURA |
| PartG, eGbR | PARTNER |
| e.V. | BOARD |
代表权
每个人员都附带两套规则。role_representation_scheme 是此人自己的权限，例如“einzelvertretungsberechtigt”（可单独代表）。organization_representation_scheme 是公司的一般规则，与基本数据中的 representation_scheme 相同。两者都有 current 和 history；对前任人员，latest 代替 current。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| related_persons.current[].role_representation_schemeobject |
此人自己的代表权，例如“einzelvertretungsberechtigt”（可单独代表）或豁免 § 181 BGB 的限制。current 为现行版本，history 为变更记录，含 value、effective_from 和 effective_to。related_persons |
– |
大多: GmbH、UG, AG、SE、KGaA, GmbH & Co. KG, KG、OHG, eG, PartG 很少: e.K. |
| related_persons.current[].organization_representation_schemeobject | 公司的一般代表规则，随每个人员一并提供。结构与 role_representation_scheme 相同。 | – |
总是: GmbH、UG, GmbH & Co. KG, KG、OHG, eG, PartG 大多: AG、SE、KGaA, e.K. |
使用实时模式获取人员
使用 realtime_mode=handelsregister-default 时，当前登记的人员直接来自 Handelsregister，即使未请求功能 related_persons。此时只收取实时模式的费用，不收取功能费用。响应中只包含 current。
在此列表中，start_date 和 end_date 为空，姓名可能较短，人员的 entity_id 可能与不使用实时模式时不同。请按姓名和出生日期匹配人员。
如果同时请求实时模式和 related_persons，current 来自实时查询，past 来自公司档案。此时功能也会计费。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| related_persons.current[].name_parts.aliasesarray |
来自实时查询的姓名写法，形式为“姓, 名”。仅在使用实时模式时提供。related_persons |
– | 总是 |
人物档案
人物档案（fetch-person）描述单个人员：此人在所有相关公司中的职务，以及公开网络来源中关于此人的信息。你可以通过姓名和一家此人现在或曾经任职的公司找到此人。
人物档案包含在 Plus 起的每个积分订阅中。由于我们会检索网络，一次请求通常需要十到三十秒。请将客户端的超时设置为至少 120 秒。
curl -G "https://handelsregister.ai/api/v1/fetch-person" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'person_q=Max Mustermann' \ --data-urlencode 'organization_q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-person", headers={"x-api-key": "YOUR_API_KEY"}, params={ "person_q": "Max Mustermann", "organization_q": "Hetzner Online GmbH", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-person"); url.searchParams.append("person_q", "Max Mustermann"); url.searchParams.append("organization_q", "Hetzner Online GmbH"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();
1{2 "entity_id": "08ed5f967956831ca6588930fd2693ed",3 "name": "Max Felix Mustermann",4 "birth_date": "1976-01-15",5 "name_parts": {6 "given": "Max Felix",7 "family": "Mustermann",8 "maiden": null,9 "canonical_name": "Mustermann, Max Felix",10 "previous_names": null11 },12 "location": {13 "home": {14 "city": "Musterheim"15 }16 },17 "bio": "Max Felix Mustermann ist Geschäftsführer der Hetzner Online GmbH und Unternehmer im Bereich Rechenzentren.",18 "expertise": [19 "Rechenzentren",20 "Hosting"21 ],22 "contact": {23 "emails": [24 {25 "address": "[email protected]",26 "type": "organization",27 "label": "Allgemeine Unternehmenskontakt-E-Mail"28 },29 {30 "address": "[email protected]",31 "type": "organization",32 "label": "E-Mail für Produktfeedback"33 }34 ],35 "phones": [36 {37 "number": "+49374574447100",38 "type": "organization",39 "entity": "Hetzner Online GmbH",40 "label": "Öffentliche Unternehmens-Telefonnummer"41 },42 {43 "number": "+49911234226100",44 "type": "organization",45 "entity": "Hetzner Online GmbH",46 "label": "Öffentliche Unternehmens-Telefonnummer"47 },48 {49 "number": "+4998315050",50 "type": "organization",51 "entity": "Hetzner Online GmbH",52 "label": "Zentrale Unternehmensnummer"53 }54 ]55 },56 "profiles": {57 "linkedin": null,58 "other": []59 },60 "affiliations": [61 {62 "organization": "ENSoXX Holding AG",63 "relation": "Vorstandsmitglied"64 },65 {66 "organization": "Hetzner Online GmbH",67 "relation": "Geschäftsführer"68 },69 {70 "organization": "ENSoXX hilft e.V.",71 "relation": "Vorstandsmitglied"72 },73 {74 "organization": "TRAIDY UG (haftungsbeschränkt)",75 "relation": "Geschäftsführer"76 },77 {78 "organization": "HT clean energy GmbH",79 "relation": "Geschäftsführer"80 },81 {82 "organization": "DreamSoXX GmbH",83 "relation": "Geschäftsführer"84 },85 {86 "organization": "Lighthouse GmbH",87 "relation": "Prokura"88 },89 {90 "organization": "ENSoXX GmbH",91 "relation": "Geschäftsführer"92 },93 {94 "organization": "ENSoXX Invest GmbH",95 "relation": "Geschäftsführer"96 },97 {98 "organization": "Sonnenkraft Merkendorf GmbH & Co. KG",99 "relation": "Kommanditist"100 },101 {102 "organization": "Modellsportclub Gunzenhausen e.V.",103 "relation": "Vorstandsmitglied"104 },105 {106 "organization": "possum Projekt 1 GmbH",107 "relation": "Prokura"108 }109 ],110 "handelsregister_roles": [111 {112 "entity_id": "94eb910fef13f94585c48c263fa446d4",113 "name": "Hetzner Online GmbH",114 "label": "BOARD",115 "role": {116 "en": "Board Member",117 "de": "Vorstandsmitglied"118 },119 "start_date": "2002-10-15",120 "end_date": "2015-07-28"121 },122 {123 "entity_id": "0b3435f83ce8591300625100815d4583",124 "name": "Hetzner Online GmbH",125 "label": "BOARD",126 "role": {127 "en": "Board Member",128 "de": "Vorstandsmitglied"129 },130 "start_date": "2002-10-15",131 "end_date": "2015-07-28"132 },133 {134 "entity_id": "0b3435f83ce8591300625100815d4583",135 "name": "Hetzner Online GmbH",136 "label": "MANAGING_DIRECTOR",137 "role": {138 "en": "Managing Director",139 "de": "Geschäftsführer"140 },141 "start_date": "2015-07-28",142 "end_date": null143 },144 {145 "entity_id": "94eb910fef13f94585c48c263fa446d4",146 "name": "Hetzner Online GmbH",147 "label": "MANAGING_DIRECTOR",148 "role": {149 "en": "Managing Director",150 "de": "Geschäftsführer"151 },152 "start_date": "2015-07-28",153 "end_date": null154 },155 {156 "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",157 "name": "ENSoXX GmbH",158 "label": "MANAGING_DIRECTOR",159 "role": {160 "en": "Managing Director",161 "de": "Geschäftsführer"162 },163 "start_date": "2015-08-14",164 "end_date": null165 },166 {167 "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",168 "name": "ENSoXX Holding AG",169 "label": "BOARD",170 "role": {171 "en": "Board Member",172 "de": "Vorstandsmitglied"173 },174 "start_date": "2016-02-03",175 "end_date": null176 },177 {178 "entity_id": "bc1c1e106ade810eb960c779d4c752a8",179 "name": "ENSoXX hilft e.V.",180 "label": "BOARD",181 "role": {182 "en": "Board Member",183 "de": "Vorstandsmitglied"184 },185 "start_date": "2017-02-24",186 "end_date": null187 },188 {189 "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",190 "name": "TRAIDY UG (haftungsbeschränkt)",191 "label": "MANAGING_DIRECTOR",192 "role": {193 "en": "Managing Director",194 "de": "Geschäftsführer"195 },196 "start_date": "2022-03-14",197 "end_date": null198 },199 {200 "entity_id": "4cd425f9ad57d6119f704ba53131b480",201 "name": "Modellsportclub Gunzenhausen e.V.",202 "label": "BOARD",203 "role": {204 "en": "Board Member",205 "de": "Vorstandsmitglied"206 },207 "start_date": "2023-06-06",208 "end_date": "2026-08-12"209 },210 {211 "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",212 "name": "ENSoXX Invest GmbH",213 "label": "MANAGING_DIRECTOR",214 "role": {215 "en": "Managing Director",216 "de": "Geschäftsführer"217 },218 "start_date": "2023-12-13",219 "end_date": null220 },221 {222 "entity_id": "2ab71b59057969183dd811adf9f32ebd",223 "name": "HT clean energy GmbH",224 "label": "MANAGING_DIRECTOR",225 "role": {226 "en": "Managing Director",227 "de": "Geschäftsführer"228 },229 "start_date": "2024-08-20",230 "end_date": null231 },232 {233 "entity_id": "260286ab8baa3a8977fddd56b9361c6c",234 "name": "DreamSoXX GmbH",235 "label": "MANAGING_DIRECTOR",236 "role": {237 "en": "Managing Director",238 "de": "Geschäftsführer"239 },240 "start_date": "2025-01-13",241 "end_date": null242 },243 {244 "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",245 "name": "Lighthouse GmbH",246 "label": "PROCURA",247 "role": {248 "en": "Procura",249 "de": "Prokura"250 },251 "start_date": "2025-03-25",252 "end_date": null253 },254 {255 "entity_id": "232d2ed634eef59eb21836cc47cb5645",256 "name": "Sonnenkraft Merkendorf GmbH & Co. KG",257 "label": "LIMITED_PARTNER",258 "role": {259 "en": "Limited Partner",260 "de": "Kommanditist"261 },262 "start_date": "2026-02-18",263 "end_date": null264 },265 {266 "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",267 "name": "possum Projekt 1 GmbH",268 "label": "PROCURA",269 "role": {270 "en": "Procura",271 "de": "Prokura"272 },273 "start_date": "2026-09-04",274 "end_date": null275 },276 {277 "entity_id": "997f1b8314b8b56573208ae2334abb1d",278 "name": "possum Projekt 1 GmbH",279 "label": "PROCURA",280 "role": {281 "en": "Procura",282 "de": "Prokura"283 },284 "start_date": "2026-09-04",285 "end_date": null286 }287 ],288 "meta": {289 "request_credit_cost": 15,290 "credits_remaining": 145291 }292}
人员
姓名、出生日期和居住地来自登记册。entity_id 与不使用实时模式的公司档案中 related_persons 里的相同。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| entity_idstring | 人员的 ID。同一 ID 也出现在不使用实时模式的公司档案的 related_persons 中。人物档案 |
"08ed5f967956831ca6588930fd2693ed" |
总是 |
| namestring | 登记册中的全名。 |
"Max Felix Mustermann" |
同上 |
| birth_datestring|null | 出生日期，格式为 YYYY-MM-DD，以登记为准。为空：未登记日期 |
"1976-01-15" |
大多 |
| name_partsobject | 拆分为各部分的姓名，结构与 related_persons 中相同。 | – | 总是 |
| name_parts.givenstring|null | 名；有多个时全部列出。 |
"Max Felix" |
同上 |
| name_parts.familystring|null | 姓。 |
"Mustermann" |
同上 |
| name_parts.canonical_namestring|null | 姓名，通常为“姓, 名”的形式，用于排序和匹配。 |
"Mustermann, Max Felix" |
同上 |
| name_parts.maidenstring|null | 出生时的姓。为空：未登记 |
null |
很少 |
| name_parts.previous_namesarray|null | 此人以前的姓名列表。为空：未登记 |
null |
同上 |
| locationobject | 此人的地点。 | – | 大多 |
| location.home.citystring|null | 居住地，以登记为准。为空：未登记居住地 |
"Musterheim" |
同上 |
职务与关联
handelsregister_roles 列出此人每个已登记的职务，以及对应的公司和期间。用公司的 entity_id 可获取其公司档案。affiliations 简要汇总来自登记册和网络的关联。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| handelsregister_rolesarray | 此人已登记的职务，含公司和期间，现任和前任。人物档案 | – | 总是 |
| handelsregister_roles[].entity_idstring | 公司的 entity_id，可在参数 q 中用于获取公司档案。 |
"0b3435f83ce8591300625100815d4583" |
同上 |
| handelsregister_roles[].namestring | 公司名称。 |
"Hetzner Online GmbH" |
同上 |
| handelsregister_roles[].labelstring | 职务的固定取值，与 related_persons 中 label 的取值相同，例如 MANAGING_DIRECTOR、BOARD、PROCURA 或 LIMITED_PARTNER。 |
"BOARD" |
同上 |
| handelsregister_roles[].roleobject | 用于显示的职务名称，de 和 en 文本。 | – | 同上 |
| handelsregister_roles[].start_datestring|null | 职务开始日期，格式为 YYYY-MM-DD。为空：开始日期未知 |
"2002-10-15" |
大多 |
| handelsregister_roles[].end_datestring|null | 职务结束日期。为空：职务仍然存在 |
"2015-07-28" |
总是 |
| affiliationsarray | 与此人关联的公司，各附关联类型。根据登记册和网络来源汇总。 | – | 同上 |
| affiliations[].organizationstring | 公司名称。 |
"ENSoXX Holding AG" |
同上 |
| affiliations[].relationstring | 关联类型，德文文本，例如 Geschäftsführer（总经理）、Prokura 或 Kommanditist（有限合伙人）。 |
"Vorstandsmitglied" |
同上 |
网络检索
我们从公开网络来源收集简介、专业领域、联系方式和来源。信息多少取决于此人在网络上的可见度。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| biostring|null | 此人的简介，一两句话，德文。为空：网络上关于此人的信息太少（此时为 null）人物档案 |
"Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…" |
大多 |
| expertisearray | 此人的专业领域和主题列表。为空：网络上关于此人的信息太少 | – | 同上 |
| contactobject | 公开列出的联系方式，含 emails 和 phones。 | – | 总是 |
| contact.emailsarray | 电子邮件地址列表。为空：未找到地址 | – | 很少 |
| contact.emails[].addressstring | 电子邮件地址。 |
"[email protected]" |
同上 |
| contact.emails[].typestring | 地址类型。organization 表示：公司的地址，而非私人地址。 |
"organization" |
同上 |
| contact.emails[].labelstring | 地址的用途，简短文本。 |
"Allgemeine Unternehmenskontakt-E-Mail" |
同上 |
| contact.phonesarray | 电话号码列表。为空：未找到号码 | – | 同上 |
| contact.phones[].numberstring | 号码，通常为国际格式。 |
"+49374574447100" |
同上 |
| contact.phones[].typestring | 号码类型。organization 表示：公司的号码。 |
"organization" |
同上 |
| contact.phones[].entitystring | 号码所属的公司。 |
"Hetzner Online GmbH" |
同上 |
| contact.phones[].labelstring | 号码的用途，例如总机或传真。 |
"Öffentliche Unternehmens-Telefonnummer" |
同上 |
| profilesobject | 关于此人的网页，含 linkedin 和 other。 | – | 总是 |
| profiles.linkedinstring|null | LinkedIn 个人主页的地址。为空：未找到 |
null |
很少 |
| profiles.otherarray | 关于此人的其他页面，例如新闻报道或团队页面，地址列表。为空：未找到 | – | 大多 |
这些信息由 AI 根据公开来源整理。我们为此采用最新技术，并在质量上投入大量精力；个别错误仍可能出现。
持股与关系网络
两个功能可扩展人物档案：shareholdings 显示此人持股的公司。network 显示此人跨两个层级关联的公司和人员。两者都仅在返回数据时计费。
| 字段 | 含义 | 示例 | 可用性 |
|---|---|---|---|
| shareholdingsobject|null |
此人目前持股的公司。为空：没有已知的持股shareholdings |
– | 部分 |
| shareholdings.holdings.currentarray | 当前持股列表。 | – | 同上 |
| shareholdings.holdings.current[].organizationobject | 公司，含 entity_id、name、status、legal_form、address 和 registration，结构与基本数据中相同。 | – | 同上 |
| shareholdings.holdings.current[].ownership.percentagenumber|null | 占资本的百分比，例如 33.33。 |
100 |
同上 |
| shareholdings.holdings.current[].ownership.contributionobject|null | 持股的名义金额，含 amount 和 currency。 | – | 同上 |
| shareholdings.holdings.current[].as_ofstring|null | 信息日期，格式为 YYYY-MM-DD。 |
"2025-01-13" |
同上 |
| shareholdings.summary.total_currentinteger | 当前持股数量。 |
3 |
同上 |
| networkobject|null |
此人跨两个层级关联的公司和人员。结构与公司档案中的 network 相同。network · Pro 起 · Beta |
– | 大多 |
| network.depthinteger | 关系网络覆盖的层级数，从此人起算。此人本身为第 0 层。 |
2 |
同上 |
| network.nodesarray | 节点：人员（PERSON）和公司（ORGANIZATION），含 entity_id、name 及所在层级。此人本身的 is_root 为 true。 | – | 同上 |
| network.connectionsarray | 两个节点之间的关联，各含 kind（ROLE、OWNERSHIP 或 GROUP）、label、期间和 is_current。 | – | 同上 |