الأشخاص والتمثيل

جلب الأشخاص

اطلب الميزة related_persons. تحتوي الاستجابة حينها على المفتاح related_persons بقائمتين: current لكل من يشغل دوره اليوم، وpast لكل من غادر. كل دور هو إدخال مستقل. في طلبنا النموذجي لـ Hetzner Online GmbH، Ansbach HRB 6089، احتوت current على ثلاثة مديرين. وظهر اثنان منهم مرة أخرى في past مع Prokura السابقة لديهما. جميع البيانات الشخصية في الاستجابات النموذجية بيانات نموذجية.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=related_persons'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["related_persons"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "related_persons");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "name": "Hetzner Online GmbH",3  "related_persons": {4    "current": [5      {6        "entity_id": "ea3a1670232611a992727ed067216d07",7        "label": "MANAGING_DIRECTOR",8        "role": {9          "en": {10            "long": "Managing Director",11            "short": "MD"12          },13          "de": {14            "long": "Geschäftsführer",15            "short": "GF"16          }17        },18        "name": "Paul Musterwald",19        "start_date": "2019-01-04",20        "end_date": null,21        "birth_date": "1989-07-18",22        "name_parts": {23          "given": "Paul",24          "family": "Musterwald",25          "maiden": null,26          "canonical_name": "Musterwald, Paul",27          "previous_names": null28        },29        "location": {30          "home": {31            "city": "Exempelingen i. Bay."32          }33        },34        "organization_representation_scheme": {35          "current": [36            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."37          ],38          "history": [39            {40              "value": [41                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."42              ],43              "effective_from": "2002-10-15",44              "effective_to": "2015-07-28"45            },46            {47              "value": [48                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."49              ],50              "effective_from": "2015-07-28",51              "effective_to": null52            }53          ]54        },55        "role_representation_scheme": {56          "current": [57            "einzelvertretungsberechtigt."58          ],59          "history": [60            {61              "value": [62                "einzelvertretungsberechtigt."63              ],64              "effective_from": "2019-01-04",65              "effective_to": null66            }67          ]68        }69      },70      {71        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72        "label": "MANAGING_DIRECTOR",73        "role": {74          "en": {75            "long": "Managing Director",76            "short": "MD"77          },78          "de": {79            "long": "Geschäftsführer",80            "short": "GF"81          }82        },83        "name": "Jan Musterhuber",84        "start_date": "2019-01-04",85        "end_date": null,86        "birth_date": "1955-11-06",87        "name_parts": {88          "given": "Jan",89          "family": "Musterhuber",90          "maiden": null,91          "canonical_name": "Musterhuber, Jan",92          "previous_names": null93        },94        "location": {95          "home": {96            "city": "Probeingen"97          }98        },99        "organization_representation_scheme": {100          "current": [101            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102          ],103          "history": [104            {105              "value": [106                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."107              ],108              "effective_from": "2002-10-15",109              "effective_to": "2015-07-28"110            },111            {112              "value": [113                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."114              ],115              "effective_from": "2015-07-28",116              "effective_to": null117            }118          ]119        },120        "role_representation_scheme": {121          "current": [122            "einzelvertretungsberechtigt."123          ],124          "history": [125            {126              "value": [127                "einzelvertretungsberechtigt."128              ],129              "effective_from": "2019-01-04",130              "effective_to": null131            }132          ]133        }134      },135      {136        "entity_id": "08ed5f967956831ca6588930fd2693ed",137        "label": "MANAGING_DIRECTOR",138        "role": {139          "en": {140            "long": "Managing Director",141            "short": "MD"142          },143          "de": {144            "long": "Geschäftsführer",145            "short": "GF"146          }147        },148        "name": "Max Felix Mustermann",149        "start_date": "2015-07-28",150        "end_date": null,151        "birth_date": "1976-01-15",152        "name_parts": {153          "given": "Max Felix",154          "family": "Mustermann",155          "maiden": null,156          "canonical_name": "Mustermann, Max Felix",157          "previous_names": null158        },159        "location": {160          "home": {161            "city": "Musterheim"162          }163        },164        "organization_representation_scheme": {165          "current": [166            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."167          ],168          "history": [169            {170              "value": [171                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."172              ],173              "effective_from": "2002-10-15",174              "effective_to": "2015-07-28"175            },176            {177              "value": [178                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."179              ],180              "effective_from": "2015-07-28",181              "effective_to": null182            }183          ]184        },185        "role_representation_scheme": {186          "current": [187            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188          ],189          "history": [190            {191              "value": [192                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193              ],194              "effective_from": "2015-07-28",195              "effective_to": null196            }197          ]198        }199      }200    ],201    "past": [202      {203        "entity_id": "ea3a1670232611a992727ed067216d07",204        "label": "PROCURA",205        "role": {206          "en": {207            "long": "Procura",208            "short": "Procura"209          },210          "de": {211            "long": "Prokura",212            "short": "Prokura"213          }214        },215        "name": "Paul Musterwald",216        "start_date": "2015-07-28",217        "end_date": "2019-01-04",218        "birth_date": "1989-07-18",219        "name_parts": {220          "given": "Paul",221          "family": "Musterwald",222          "maiden": null,223          "canonical_name": "Musterwald, Paul",224          "previous_names": null225        },226        "location": {227          "home": {228            "city": "Exempelingen i. Bay."229          }230        },231        "organization_representation_scheme": {232          "latest": [233            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."234          ],235          "history": [236            {237              "value": [238                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."239              ],240              "effective_from": "2002-10-15",241              "effective_to": "2015-07-28"242            },243            {244              "value": [245                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."246              ],247              "effective_from": "2015-07-28",248              "effective_to": null249            }250          ]251        },252        "role_representation_scheme": {253          "latest": [254            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255          ],256          "history": [257            {258              "value": [259                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260              ],261              "effective_from": "2015-07-28",262              "effective_to": "2019-01-04"263            }264          ]265        }266      },267      {268        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269        "label": "PROCURA",270        "role": {271          "en": {272            "long": "Procura",273            "short": "Procura"274          },275          "de": {276            "long": "Prokura",277            "short": "Prokura"278          }279        },280        "name": "Jan Musterhuber",281        "start_date": "2015-07-28",282        "end_date": "2019-01-04",283        "birth_date": "1955-11-06",284        "name_parts": {285          "given": "Jan",286          "family": "Musterhuber",287          "maiden": null,288          "canonical_name": "Musterhuber, Jan",289          "previous_names": null290        },291        "location": {292          "home": {293            "city": "Probeingen"294          }295        },296        "organization_representation_scheme": {297          "latest": [298            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."299          ],300          "history": [301            {302              "value": [303                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."304              ],305              "effective_from": "2002-10-15",306              "effective_to": "2015-07-28"307            },308            {309              "value": [310                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."311              ],312              "effective_from": "2015-07-28",313              "effective_to": null314            }315          ]316        },317        "role_representation_scheme": {318          "latest": [319            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320          ],321          "history": [322            {323              "value": [324                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325              ],326              "effective_from": "2015-07-28",327              "effective_to": "2019-01-04"328            }329          ]330        }331      },332      {333        "entity_id": "08ed5f967956831ca6588930fd2693ed",334        "label": "BOARD",335        "role": {336          "en": {337            "long": "Board Member",338            "short": "Board"339          },340          "de": {341            "long": "Vorstandsmitglied",342            "short": "Vorstand"343          }344        },345        "name": "Max Felix Mustermann",346        "start_date": "2002-10-15",347        "end_date": "2015-07-28",348        "birth_date": "1976-01-15",349        "name_parts": {350          "given": "Max Felix",351          "family": "Mustermann",352          "maiden": null,353          "canonical_name": "Mustermann, Max Felix",354          "previous_names": null355        },356        "location": {357          "home": {358            "city": "Musterheim"359          }360        },361        "organization_representation_scheme": {362          "latest": [363            "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."364          ],365          "history": [366            {367              "value": [368                "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."369              ],370              "effective_from": "2002-10-15",371              "effective_to": "2015-07-28"372            },373            {374              "value": [375                "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."376              ],377              "effective_from": "2015-07-28",378              "effective_to": null379            }380          ]381        },382        "role_representation_scheme": {383          "latest": [384            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385          ],386          "history": [387            {388              "value": [389                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390              ],391              "effective_from": "2002-10-15",392              "effective_to": "2015-07-28"393            }394          ]395        }396      }397    ]398  }399}

200 · مثال على استجابة: Hetzner Online GmbH مع الميزة related_persons، مختصرة إلى الاسم والأشخاص

الحقل
الحقل	المعنى	مثال	التوفر
related_personsobject\|null	جميع الأشخاص المسجلين للشركة، مقسّمين إلى current وpast.`related_persons`	–	دائمًا
related_persons.currentarray	الأشخاص الذين يشغلون دورهم اليوم.	–	كما في الأعلى
related_persons.pastarray	الأشخاص الذين غادروا، بالحقول نفسها التي في current. في قاعدتي التمثيل يحل latest محل current: آخر نسخة قبل المغادرة.فارغ عندما لم يغادر أحد منذ التسجيل	–	غالبًا

حقول الشخص

لكل إدخال في current وpast الحقول نفسها. دون الوقت الفعلي يكون للشخص الـ entity_id نفسه في جميع ملفات الشركات وفي ملف الشخص. وبذلك تتعرف عليه عبر الشركات. أما الأشخاص من استعلام الوقت الفعلي فلهم معرّفات خاصة.

الحقل
الحقل	المعنى	مثال	التوفر
related_persons.current[].entity_idstring\|null	معرّف الشخص. دون الوقت الفعلي يكون هو نفسه في جميع ملفات الشركات ويطابق الـ 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`	دائمًا

المديرون ومجلس الإدارة

يحمل مديرو (Geschäftsführer) GmbH أو UG التسمية MANAGING_DIRECTOR. وتتعرف على مجلس الإدارة (Vorstand) لـ AG أو SE أو eG من BOARD، وعلى رئيسه من BOARD_CHAIR. وعند حلّ الشركة يتولى المصفّون بـ LIQUIDATOR التمثيل.

افحص الأدوار دائمًا عبر label. النصوص في role مخصصة للعرض.

Prokura

Prokura هي التوكيل المسجل لتمثيل الشركة في جميع الأعمال تقريبًا. يحمل حاملو Prokura (Prokuristen) التسمية PROCURA. وما إذا كان يحق لشخص التصرف منفردًا أو بالاشتراك مع آخرين فقط موجود في role_representation_scheme، مثل «Gesamtprokura gemeinsam mit einem Vorstandsmitglied» (Prokura مشتركة مع عضو في مجلس الإدارة).

الشركاء المتضامنون

في KG وOHG وKGaA يمثّل الشركاءُ المتضامنون (persönlich haftende Gesellschafter) الشركة. ويحملون التسمية FULLY_LIABLE_PARTNER. والشركاء الموصون (Kommanditisten) في KG مسجلون بـ LIMITED_PARTNER، ومالك e.K. بـ OWNER، وشركاء PartG أو eGbR بـ PARTNER.

في GmbH & Co. KG يكون الشريك المتضامن عادةً GmbH بحد ذاتها. تجد مديريها في ملف الشركة الخاص بتلك الـ GmbH.

الأدوار حسب الشكل القانوني

الأدوار الموجودة في الشركة تنتج عن شكلها القانوني. يبيّن الجدول التسميات التي تراها عادةً لكل شكل قانوني. جميع التسميات مع معناها مذكورة أعلاه تحت 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 يأتي الأشخاص المسجلون حاليًا مباشرةً من السجل التجاري، حتى دون الميزة 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}

200 · مثال على استجابة: ملف الشخص Max Felix Mustermann (بيانات نموذجية) لدى Hetzner Online GmbH، مختصر

الشخص

الاسم وتاريخ الميلاد ومكان الإقامة تأتي من السجل. الـ entity_id هو نفسه الموجود في related_persons في ملفات الشركات دون الوقت الفعلي.

الحقل
الحقل	المعنى	مثال	التوفر
entity_idstring	معرّف الشخص. يظهر المعرّف نفسه في 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	الدور كقيمة ثابتة، بالقيم نفسها التي في label ضمن related_persons، مثل 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	صفحات أخرى عن الشخص، مثل المقالات الصحفية أو صفحات الفريق، كقائمة عناوين.فارغ عندما لم يُعثر على صفحات	–	غالبًا

يجمع ذكاء اصطناعي هذه المعلومات من مصادر عامة. نستخدم لذلك أحدث التقنيات ونستثمر كثيرًا في الجودة؛ ومع ذلك تبقى أخطاء فردية ممكنة.

المشاركات والشبكة

ميزتان توسّعان ملف الشخص: تُظهر 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 والاسم ومستواها. ولدى الشخص نفسه is_root بقيمة true.	–	كما في الأعلى
network.connectionsarray	الروابط بين عقدتين، لكلٍّ منها kind (ROLE أو OWNERSHIP أو GROUP) وlabel والفترة وis_current.	–	كما في الأعلى

fetch-organization نقطة النهاية مع الميزة related_persons والوقت الفعلي. fetch-person جلب ملف الشخص: المعاملات والتكاليف والأخطاء. العثور على المديرين والشركاء خطوة بخطوة من الشركة إلى أشخاصها. الشركاء والمشاركات من يملك الشركة وفي أي شركات تملك حصصًا.