الشركاء والمشاركات – التوثيق

الميزة
الميزة	ما تُرجعه	الأرصدة	متاحة في
shareholders	المساهمون: الشركاء الحاليون مع حصصهم وقوائم الشركاء السابقة	5	كل حساب · Beta
shareholders_deep	المساهمون بالتفصيل: الحائزون مع أرقام الحصص، ومنذ متى يملكون حصصًا، وما الذي تغيّر آخر مرة	80	Max
ubos	المستفيدون الحقيقيون (UBO): الأشخاص الذين يقفون وراء الشركة، محسوبين من قوائم الشركاء	10	كل حساب · Beta
shareholdings	المشاركات: الشركات التي تملك الشركة نفسها حصصًا فيها	5	كل حساب · Beta

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

ما يقوله السجل عن المالكين يتوقف على الشكل القانوني. يبيّن الجدول ما تحصل عليه عادةً.

الشكل القانوني
الشكل القانوني	الشركاء في الاستجابة
GmbH, UG	جميع الشركاء من قائمة الشركاء وفق § 40 GmbHG، مع المبلغ الاسمي والحصة من رأس المال (Stammkapital)، إضافةً إلى القوائم السابقة.
AG, SE, KGaA	في حالات فردية فقط، لأن مساهمي AG غير مدرجين في أي سجل عام.
GmbH & Co. KG	الشركاء الموصون (Kommanditisten) من السجل مع مبلغ مسؤوليتهم، وأحيانًا أيضًا الـ GmbH الشريكة المتضامنة.
KG, OHG	الشركاء المسجلون: في KG الشركاء المتضامنون (Komplementäre) والشركاء الموصون، وفي OHG الشركاء ذوو المسؤولية الشخصية.
e.K.	المالك.
eG	لا شيء. قائمة أعضاء الجمعية التعاونية ليست علنية.
PartG	الشركاء المسجلون.

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

الشركاء

تُرجع الميزة shareholders الشركاء الحاليين: لـ GmbH من أحدث قائمة شركاء، ولشركات الأشخاص والتجار الأفراد من السجل. تكلّف 5 رصيد، ولكن فقط عندما تذكر شركاء حاليين. وإذا أرجعت قوائم سابقة فقط، فلا تكلّف شيئًا.

يصف كل إدخال في entries شخصًا أو شركة. للشخص first_name وlast_name وbirth_date، وللشركة entity_name وcountry_code وregistration_reference.

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=shareholders'

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": ["shareholders"],
    },
)
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", "shareholders");

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

الحقل
الحقل	المعنى	مثال	التوفر
shareholdersobject\|null	شركاء الشركة: الحالة الحالية في entries، والحالات السابقة في history.فارغ عندما لا يوجد شركاء معروفون، مثلًا لـ AG أو eG`shareholders` · Beta	–	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders.entriesarray	الشركاء الحاليون، إدخال واحد لكل شخص أو شركة.	–	كما في الأعلى
shareholders.entries[].shareholderobject	من يملك الحصة: شخص أو شركة، بالحقول أدناه.	–	كما في الأعلى
shareholders.entries[].shareholder.entity_idstring\|null	معرّف الشخص أو الشركة، لملف الشخص أو ملف الشركة الخاص به.فارغ عندما تعذّرت مطابقة الشريك بيقين	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	كما في الأعلى
shareholders.entries[].shareholder.first_namestring	الاسم الأول للشخص، مع جميع الأسماء الأولى المسجلة.	–	دائمًا: e.K. غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders.entries[].shareholder.last_namestring	اسم عائلة الشخص.	–	كما في الأعلى
shareholders.entries[].shareholder.birth_datestring\|null	تاريخ ميلاد الشخص، بالصيغة YYYY-MM-DD.فارغ عندما لا يذكر المستند تاريخ ميلاد	–	كما في الأعلى
shareholders.entries[].shareholder.entity_namestring	اسم شركة هي شريك.	`"ENSoXX GmbH"`	غالبًا: GmbH, UG, GmbH & Co. KG نادرًا: AG, SE, KGaA, KG, OHG أبدًا: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	بلد الشركة كرمز ISO من ثلاثة أحرف (ISO 3166-1 alpha-3)، مثل DEU.	`"DEU"`	كما في الأعلى
shareholders.entries[].shareholder.registration_referencestring\|null	قيد الشركة في السجل كنص، كما يظهر في المستند.فارغ عندما لا يذكر المستند قيدًا في السجل، وكثيرًا ما يحدث ذلك للشركات الأجنبية	`"AG Ansbach HRB 6105"`	كما في الأعلى
shareholders.entries[].shareholder.addressstring\|null	العنوان أو مكان الإقامة أو المقر كنص، كما يظهر في المستند.فارغ عندما لا يذكر المستند عنوانًا	`"Gunzenhausen"`	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders.entries[].contributionobject\|null	مبلغ المشاركة مع amount وcurrency: لـ GmbH المبلغ الاسمي للحصص، وللشركاء الموصين مبلغ المسؤولية المسجل (Haftsumme).فارغ عندما لا يوجد مبلغ مسجل، مثلًا للشركاء ذوي المسؤولية الشخصية أو لمالك e.K	–	غالبًا: GmbH, UG, GmbH & Co. KG أحيانًا: KG, OHG نادرًا: AG, SE, KGaA أبدًا: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	الحصة من رأس المال كعدد عشري: 1 تعني 100 %، و0.245 تعني 24.5 %.فارغ عندما لا يمكن استنتاج حصة، مثلًا لشركات الأشخاص	`0.945`	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders.entries[].roleobject	الدور: label كرمز ثابت، إضافةً إلى de وen باسم طويل وقصير، مثل Kommanditist وKom.	–	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders.entries[].role.labelstring	الدور كرمز ثابت. قد تُضاف قيم جديدة.القيم: `SHAREHOLDER` شريك وفق قائمة الشركاء, `LIMITED_PARTNER` شريك موصٍ (Kommanditist), `FULLY_LIABLE_PARTNER` شريك بمسؤولية شخصية (persönlich haftender Gesellschafter), `PARTNER` شريك في PartG, `OWNER` مالك e.K.	`"SHAREHOLDER"`	كما في الأعلى
shareholders.total_capitalobject\|null	رأس المال وفق قائمة الشركاء، مع amount وcurrency، وهو أساس contribution_ratio.فارغ عندما لا تذكر القائمة رأس مال، وكذلك لشركات الأشخاص	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG

بالـ entity_id الخاص بالشريك تجلب ملف الشركة أو ملف الشخص الخاص به. وبهذا تتتبع سلسلة الملكية مستوى بعد مستوى.

تاريخ الشركاء

يأتي shareholders.history دون تكلفة إضافية. ويحتوي على تاريخ القائمة الحالية وقوائم الشركاء السابقة، الأحدث أولًا.

في KG أو GmbH & Co. KG يوجد الشركاء السابقون في register_ownership، مع تواريخ الدخول والخروج من السجل. أما لـ OHG وPartG وe.K. فتجدهم في shareholders_deep.

الحقل
الحقل	المعنى	مثال	التوفر
shareholders.historyobject	الحالات السابقة للشركاء، دون تكلفة إضافية.فارغ عندما لا توجد حالات سابقة؛ ويغيب الحقل حينها، مثلًا لـ OHG أو PartG أو e.K`shareholders` · Beta	–	غالبًا: GmbH, UG أحيانًا: GmbH & Co. KG, KG, OHG نادرًا: AG, SE, KGaA أبدًا: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	تاريخ قائمة الشركاء التي جاءت منها entries.فارغ عندما الشركاء مأخوذون من السجل	`"2015-08-21"`	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders.history.pastarray	قوائم الشركاء السابقة، الأحدث أولًا.فارغ عندما توجد قائمة واحدة فقط	–	كما في الأعلى
shareholders.history.past[].as_ofstring	تاريخ قائمة الشركاء هذه.	`"2015-07-28"`	كما في الأعلى
shareholders.history.past[].data.total_capitalobject\|null	رأس المال وفق هذه القائمة، مع amount وcurrency. القوائم الأقدم تذكره أحيانًا بـ DEM.	–	كما في الأعلى
shareholders.history.past[].data.shareholdersarray	الشركاء وفق هذه القائمة، بالحقول نفسها التي في entries.	–	كما في الأعلى
shareholders.history.register_ownershipobject	لـ KG وGmbH & Co. KG: الشركاء السابقون وفق السجل، في past.	–	أحيانًا: GmbH & Co. KG, KG, OHG أبدًا: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	الشريك السابق، بالحقول نفسها التي في entries.	–	كما في الأعلى
shareholders.history.register_ownership.past[].roleobject	دوره، بالبنية نفسها التي لـ role في entries.	–	كما في الأعلى
shareholders.history.register_ownership.past[].effective_fromstring\|null	منذ متى كان مسجلًا، بالصيغة YYYY-MM-DD.	`"2022-01-07"`	كما في الأعلى
shareholders.history.register_ownership.past[].effective_tostring\|null	حتى متى كان مسجلًا.	`"2026-07-06"`	كما في الأعلى
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true إذا كان effective_to مستنتجًا وغير مسجل صراحةً.	`false`	كما في الأعلى
shareholders.history.register_ownership.past[].contributionnull	دائمًا null هنا.	–	كما في الأعلى
shareholders.history.register_ownership.past[].contribution_rationull	دائمًا null هنا.	–	كما في الأعلى

المساهمون بالتفصيل

الميزة shareholders_deep متاحة مع خطة Max. تكلّف 80 رصيد، ولكن فقط عندما يذكر المستند الحالي حائزًا واحدًا على الأقل.

تقرأ جميع قوائم الشركاء للشركة، وليس أحدثها فقط. وبهذا تُظهر منذ متى يملك شخص ما حصصًا، وكيف بدت الحالات السابقة، وما الذي غيّرته القائمة الأخيرة.

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=shareholders_deep'

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": ["shareholders_deep"],
    },
)
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", "shareholders_deep");

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

المستند. يذكر record مصدر الحالة الحالية، ويعطي share_capital رأس المال وفق ذلك المستند.

الحقل
الحقل	المعنى	مثال	التوفر
shareholders_deepobject\|null	الحائزون والحصص والمستندات السابقة والتغيير الأخير.فارغ عندما لا يوجد مستند حالي ولا شريك مسجل معروف، وهذا معتاد لـ AG وSE وeG`shareholders_deep` · بدءًا من Max	–	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.recordobject	المستند الذي جاءت منه الحالة الحالية: التاريخ والمصدر.	–	كما في الأعلى
shareholders_deep.record.datestring\|null	التاريخ الذي يشير إليه المستند. وهو عادةً بعد وقت قصير من التغيير الذي يُظهره المستند.فارغ عندما الشركاء مأخوذون من السجل (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.record.sourcestring	نوع المستند.القيم: `SHAREHOLDER_LIST` قائمة الشركاء (Gesellschafterliste), `FOUNDING_DOCUMENT` مستند التأسيس، أي Musterprotokoll (المحضر النموذجي) أو Gesellschaftsvertrag (عقد التأسيس), `COMMERCIAL_REGISTER` شركاء أو مالكون مسجلون في السجل	`"SHAREHOLDER_LIST"`	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.share_capitalobject\|null	رأس المال وفق المستند: value وcurrency وbasis.فارغ عندما لا يذكر المستند رأس مال، ودائمًا لـ COMMERCIAL_REGISTER	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	من أين يأتي المبلغ.القيم: `REPORTED` مذكور في المستند, `CALCULATED` محسوب من عدد الحصص ومبلغها الاسمي	`"REPORTED"`	كما في الأعلى

الحائزون. كل إدخال في entries هو سطر واحد من المستند، والحصة الأكبر أولًا. إذا كان لشخص عدة أسطر، يظهر عدة مرات في القائمة.

الحقل
الحقل	المعنى	مثال	التوفر
shareholders_deep.entriesarray	الحائزون الحاليون، سطر واحد من المستند لكل إدخال، والحصة الأكبر أولًا.`shareholders_deep` · بدءًا من Max	–	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.entries[].holderobject	من يملك الحصة. يحدّد type الحقول التي تليه.	–	كما في الأعلى
shareholders_deep.entries[].holder.typestring	نوع الحائز.القيم: `ORGANIZATION` شركة أو منظمة أخرى, `PERSON` شخص طبيعي, `JOINT` حصة مملوكة بالاشتراك، مثلًا لجماعة ورثة، مع members	`"ORGANIZATION"`	كما في الأعلى
shareholders_deep.entries[].holder.entity_idstring\|null	معرّف الحائز، لملف الشركة أو ملف الشخص الخاص به.فارغ عندما تعذّرت مطابقة الحائز بيقين، ودائمًا لـ JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	كما في الأعلى
shareholders_deep.entries[].holder.namestring	الاسم. للحائزين المطابَقين الاسم الحالي، وإلا كما في المستند.	`"ENSoXX GmbH"`	كما في الأعلى
shareholders_deep.entries[].holder.birth_datestring\|null	للأشخاص فقط: تاريخ الميلاد.فارغ عندما لا يذكره المستند	–	دائمًا: e.K. غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.entries[].holder.legal_formstring\|null	للمنظمات فقط: الشكل القانوني كنص، مثل GmbH أو Ltd.	`"GmbH"`	غالبًا: GmbH, UG, GmbH & Co. KG نادرًا: AG, SE, KGaA, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	للمنظمات فقط: الحالة الحالية في السجل.فارغ عندما الحائز غير مطابَق، ودائمًا في المستندات السابقة في historyالقيم: `ACTIVE` نشطة, `INACTIVE` لم تعد نشطة، مثلًا مشطوبة أو مندمجة	`"ACTIVE"`	كما في الأعلى
shareholders_deep.entries[].holder.citystring\|null	المقر أو مكان الإقامة.	`"Gunzenhausen"`	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.entries[].holder.countrystring\|null	البلد كرمز ISO من ثلاثة أحرف (ISO 3166-1 alpha-3)، مثل DEU أو AUT أو LUX.	`"DEU"`	كما في الأعلى
shareholders_deep.entries[].holder.registrationobject\|null	للمنظمات فقط: court وregister_type وregister_number.فارغ عندما لا يمكن قراءة قيد في السجل، مثلًا لكثير من الشركات الأجنبية	–	غالبًا: GmbH, UG, GmbH & Co. KG نادرًا: AG, SE, KGaA, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	للمنظمات فقط: قيد السجل كنص، عندما يغيب registration أو لا يذكر محكمة.	`null`	نادرًا
shareholders_deep.entries[].rolestring	دور الحائز. قد تُضاف قيم جديدة.القيم: `SHAREHOLDER` شريك وفق قائمة الشركاء أو مستند التأسيس, `LIMITED_PARTNER` شريك موصٍ (Kommanditist), `FULLY_LIABLE_PARTNER` شريك بمسؤولية شخصية (persönlich haftender Gesellschafter), `PARTNER` شريك في PartG, `OWNER` مالك e.K.	`"SHAREHOLDER"`	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.entries[].sincestring\|null	منذ متى يملك الحائز حصصًا. للشركاء المسجلين تاريخ القيد.فارغ عندما لا يمكن تحديد تاريخ، ودائمًا لـ JOINT	`"2015-08-18"`	كما في الأعلى
shareholders_deep.entries[].since_basisstring\|null	مدى يقين since.القيم: `ENTRY_RECORDED` موثّق منذ هذا التاريخ: القائمة السابقة لا تذكر الحائز بعد, `EARLIEST_RECORD` موجود بالفعل في أقدم مستند متاح، أي شريك منذ هذا التاريخ على الأقل	`"ENTRY_RECORDED"`	كما في الأعلى

الحصة. يصف ownership مقدار ما يملكه الحائز: بالنسبة المئوية، وكمبلغ اسمي، وبالأرقام التسلسلية للحصص.

الحقل
الحقل	المعنى	مثال	التوفر
shareholders_deep.entries[].ownershipobject	حصة الحائز.`shareholders_deep` · بدءًا من Max	–	غالبًا: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG نادرًا: AG, SE, KGaA أبدًا: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	الحصة من رأس المال بالنسبة المئوية، من 0 إلى 100. وهي المشاركة المباشرة، وليست حقوق التصويت.فارغ عندما لا يمكن تحديد الحصة بشكل موثوق، ودائمًا للشركاء المسجلين في شركات الأشخاص	`94.5`	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	من أين يأتي percentage.القيم: `REPORTED` مذكور في المستند أو مستنتج من المبلغ الاسمي ورأس المال في المستند, `CALCULATED` محسوب من عدد الحصص ومبلغها الاسمي	`"REPORTED"`	كما في الأعلى
shareholders_deep.entries[].ownership.nominal_amountobject\|null	مجموع المبالغ الاسمية مع value وcurrency. وللشركاء الموصين مبلغ المسؤولية المسجل (Haftsumme).فارغ عندما لا يوجد مبلغ معروف	–	غالبًا: GmbH, UG, GmbH & Co. KG أحيانًا: KG, OHG نادرًا: AG, SE, KGaA أبدًا: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	عدد الحصص (Geschäftsanteile).فارغ عندما العدد غير معروف لجميع الحصص	`47250`	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	الحصص حسب أرقامها التسلسلية في القائمة، نطاق واحد لكل سلسلة من الحصص المتماثلة.	–	كما في الأعلى
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	أول رقم تسلسلي في النطاق.	`1`	كما في الأعلى
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	آخر رقم تسلسلي في النطاق.	`47250`	كما في الأعلى
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	عدد الحصص في النطاق.	`47250`	كما في الأعلى
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	المبلغ الاسمي لكل حصة في النطاق، مع value وcurrency.	–	كما في الأعلى

التاريخ والتغييرات. يحتوي history على المستندات السابقة بالحقول نفسها. ويظهر الحائزون هناك كما وردوا في المستند آنذاك. ويقارن changes الحالة الحالية بالسابقة.

الحقل
الحقل	المعنى	مثال	التوفر
shareholders_deep.historyarray	المستندات السابقة، الأحدث أولًا، لكلٍّ منها record وshare_capital وentries. ويُجمع الشركاء المسجلون السابقون في الإدخال الأخير.`shareholders_deep` · بدءًا من Max	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	لـ JOINT: الحائزون المشتركون من النوع PERSON أو ORGANIZATION، بالحقول نفسها التي لـ holder.	–	نادرًا
shareholders_deep.history[].entries[].untilstring\|null	فقط في عنصر history الذي يحمل COMMERCIAL_REGISTER: متى غادر الشريك.	–	أحيانًا: GmbH & Co. KG, KG, OHG, PartG نادرًا: e.K. أبدًا: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	ما الذي تغيّر مع المستند الحالي مقارنةً بالسابق.فارغ عندما لا يوجد مستند سابق، وكذلك عندما تأتي الحالة الحالية من السجل أو من مستند تأسيس	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	تاريخ المستند السابق.	`"2015-07-16"`	كما في الأعلى
shareholders_deep.changes.joinedarray	الحائزون الجدد: holder مع entity_id وtype وname، إضافةً إلى percentage.	–	كما في الأعلى
shareholders_deep.changes.leftarray	الحائزون الذين غادروا، مع الحصة التي كانت لهم أخيرًا.	–	كما في الأعلى
shareholders_deep.changes.changedarray	الحائزون الذين تغيّرت حصتهم.	–	كما في الأعلى
shareholders_deep.changes.changed[].percentage_beforenumber\|null	الحصة بالنسبة المئوية في المستند السابق.	`100`	كما في الأعلى
shareholders_deep.changes.changed[].percentage_afternumber\|null	الحصة بالنسبة المئوية في المستند الحالي.	`5.5`	كما في الأعلى

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholders_deep": {5    "record": {6      "date": "2015-08-18",7      "source": "SHAREHOLDER_LIST"8    },9    "share_capital": {10      "value": 50000,11      "currency": "EUR",12      "basis": "REPORTED"13    },14    "entries": [15      {16        "holder": {17          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",18          "type": "ORGANIZATION",19          "name": "ENSoXX GmbH",20          "legal_form": "GmbH",21          "status": "ACTIVE",22          "city": "Gunzenhausen",23          "country": "DEU",24          "registration": {25            "court": "Ansbach",26            "register_type": "HRB",27            "register_number": "6105"28          },29          "registration_text": null30        },31        "role": "SHAREHOLDER",32        "ownership": {33          "percentage": 94.5,34          "percentage_basis": "REPORTED",35          "nominal_amount": {36            "value": 47250,37            "currency": "EUR"38          },39          "share_count": 47250,40          "share_ranges": [41            {42              "from": 1,43              "to": 47250,44              "count": 47250,45              "nominal_value": {46                "value": 1,47                "currency": "EUR"48              }49            }50          ]51        },52        "since": "2015-08-18",53        "since_basis": "ENTRY_RECORDED"54      },55      {56        "holder": {57          "entity_id": "08ed5f967956831ca6588930fd2693ed",58          "type": "PERSON",59          "name": "Max Felix Mustermann",60          "birth_date": "1976-01-15",61          "city": "Musterheim",62          "country": "DEU"63        },64        "role": "SHAREHOLDER",65        "ownership": {66          "percentage": 5.5,67          "percentage_basis": "REPORTED",68          "nominal_amount": {69            "value": 2750,70            "currency": "EUR"71          },72          "share_count": 2750,73          "share_ranges": [74            {75              "from": 47251,76              "to": 50000,77              "count": 2750,78              "nominal_value": {79                "value": 1,80                "currency": "EUR"81              }82            }83          ]84        },85        "since": "2015-07-16",86        "since_basis": "EARLIEST_RECORD"87      }88    ],89    "history": [90      {91        "record": {92          "date": "2015-07-16",93          "source": "SHAREHOLDER_LIST"94        },95        "share_capital": {96          "value": 50000,97          "currency": "EUR",98          "basis": "REPORTED"99        },100        "entries": [101          {102            "holder": {103              "entity_id": "08ed5f967956831ca6588930fd2693ed",104              "type": "PERSON",105              "name": "Max Mustermann",106              "birth_date": "1976-01-15",107              "city": null,108              "country": null109            },110            "role": "SHAREHOLDER",111            "ownership": {112              "percentage": 100,113              "percentage_basis": "REPORTED",114              "nominal_amount": {115                "value": 50000,116                "currency": "EUR"117              },118              "share_count": 50000,119              "share_ranges": [120                {121                  "from": 1,122                  "to": 50000,123                  "count": 50000,124                  "nominal_value": {125                    "value": 1,126                    "currency": "EUR"127                  }128                }129              ]130            },131            "since": "2015-07-16",132            "since_basis": "EARLIEST_RECORD"133          }134        ]135      }136    ],137    "changes": {138      "compared_to": "2015-07-16",139      "joined": [140        {141          "holder": {142            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",143            "type": "ORGANIZATION",144            "name": "ENSoXX GmbH"145          },146          "percentage": 94.5147        }148      ],149      "left": [],150      "changed": [151        {152          "holder": {153            "entity_id": "08ed5f967956831ca6588930fd2693ed",154            "type": "PERSON",155            "name": "Max Felix Mustermann"156          },157          "percentage_before": 100,158          "percentage_after": 5.5159        }160      ]161    }162  }163}

200 · مثال على استجابة: Hetzner Online GmbH مع الميزة shareholders_deep

مقارنةً بـ shareholders تضيف shareholders_deep أرقام الحصص، والتاريخ الذي يملك منذه شخص ما حصصًا، والتغييرات، والحصص المملوكة بالاشتراك مع أعضائها. للمقارنات عبر الشركات والسنوات، الأفضل استخدام الميزة نفسها في كل مكان.

المستفيدون الحقيقيون

المستفيدون الحقيقيون هم الأشخاص الطبيعيون الذين يملكون الشركة في النهاية. تتتبع الميزة ubos قوائم الشركاء عبر مستويات الملكية حتى الوصول إلى الأشخاص. تذكر القائمة كل شخص بحصة محسوبة، دون حد أدنى. تكلّف 10 رصيد عندما تُرجع بيانات.

إذا تعذّر ردّ حصة إلى شخص، فهي موجودة في unresolved_beneficial_owners مع السبب. وكثيرًا ما تملكها شركة في الخارج. بياناتنا تغطي الشركات الألمانية، لذا لا نعرف شركاء شركة في الخارج. يُظهر coverage النسبة المئوية من رأس المال التي رُدّت إلى أشخاص وكم يبقى مفتوحًا. ولا يبلغ مجموع القيمتين 100 دائمًا. وللباقي لا تذكر بيانات الشركاء أي حائز.

تُحتسب الميزة بمجرد أن تُرجع نتيجة. وينطبق ذلك أيضًا عندما تكون جميع الحصص في unresolved_beneficial_owners.

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=ubos'

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": ["ubos"],
    },
)
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", "ubos");

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

الحقل
الحقل	المعنى	مثال	التوفر
ubosobject\|null	المستفيدون الحقيقيون، محسوبين من قوائم الشركاء عبر مستويات الملكية.فارغ عندما لا يمكن بناء سلسلة من قوائم الشركاء، مثلًا لـ AG أو eG أو e.K`ubos` · Beta	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
ubos.beneficial_ownersarray	الأشخاص الذين يملكون الشركة مباشرةً أو عبر شركات أخرى.فارغ عندما لا يمكن ردّ أي حصة إلى شخص	–	كما في الأعلى
ubos.beneficial_owners[].personobject	الشخص، بالحقول أدناه.	–	أحيانًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	معرّف الشخص، لملف الشخص.فارغ عندما تعذّرت مطابقة الشخص بيقين	–	كما في الأعلى
ubos.beneficial_owners[].person.namestring	الاسم الكامل.	–	كما في الأعلى
ubos.beneficial_owners[].person.name_partsobject	الاسم مقسّمًا: given وfamily، وcanonical_name عندما يكون معروفًا.	–	كما في الأعلى
ubos.beneficial_owners[].person.birth_datestring\|null	تاريخ الميلاد.	–	كما في الأعلى
ubos.beneficial_owners[].person.locationobject\|null	مكان الإقامة في home: city وcounty وstate وcountry.فارغ عندما لا يوجد مكان إقامة معروف	–	كما في الأعلى
ubos.beneficial_owners[].ownership_percentagenumber	إجمالي حصة الشخص بالنسبة المئوية، مجموعًا عبر جميع المسارات.	`50`	كما في الأعلى
ubos.beneficial_owners[].pathsarray	كل مسار إلى الشخص، مع الحصة على طول ذلك المسار.	–	كما في الأعلى
ubos.beneficial_owners[].paths[].percentagenumber	الحصة بالنسبة المئوية التي تصل عبر هذا المسار.	`50`	كما في الأعلى
ubos.beneficial_owners[].paths[].viaarray	الشركات على هذا المسار، أولًا الشريك المباشر للشركة المطلوبة (depth 1). الحقول هي نفسها التي في via للحصص غير المحلولة.فارغ عندما الشخص يملك الحصص مباشرةً	–	كما في الأعلى

الحقل
الحقل	المعنى	مثال	التوفر
ubos.unresolved_beneficial_ownersarray	حصص تعذّر ردّها إلى شخص.فارغ عندما جميع الحصص محلولة`ubos` · Beta	–	غالبًا: GmbH, UG نادرًا: AG, SE, KGaA, GmbH & Co. KG, KG, OHG أبدًا: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	لماذا تنتهي السلسلة هنا. قد تُضاف قيم جديدة.القيم: `unlinked` الشريك شركة لا نستطيع مطابقتها مع قيد في السجل الألماني، وعادةً شركة في الخارج. لا نعرف شركاءها، لذا تنتهي السلسلة هنا, `no_further_shareholder_data` الشريك شركة ألمانية نعرفها، لكن لا توجد لها قائمة شركاء، مثلًا KG, `cycle` تعود السلسلة إلى شركة موجودة فيها بالفعل، مثلًا عندما تملك شركة حصصها الخاصة, `unknown` لا شيء معروف عن الشريك، لا الاسم ولا الحصة	`"cycle"`	كما في الأعلى
ubos.unresolved_beneficial_owners[].namestring\|null	اسم الشريك الذي تنتهي عنده السلسلة.فارغ عندما السبب هو unknown	`"ENSoXX Holding AG"`	كما في الأعلى
ubos.unresolved_beneficial_owners[].entity_idstring\|null	معرّفه، لملف الشركة الخاص به.فارغ عندما الشريك غير مطابَق مع شركة في بياناتنا، أي للسببين unlinked وunknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	كما في الأعلى
ubos.unresolved_beneficial_owners[].legal_formstring\|null	شكله القانوني.	`"AG"`	كما في الأعلى
ubos.unresolved_beneficial_owners[].addressobject\|array	عنوانه مع street وhouse_number وpostal_code وcity وcounty وstate وcountry وcoordinates.فارغ عندما لا يوجد عنوان معروف؛ وتكون القيمة حينها قائمة فارغة []	–	كما في الأعلى
ubos.unresolved_beneficial_owners[].registrationobject\|array	قيده في السجل مع court وregister_type وregister_number، وكذلك من سجلات أجنبية.فارغ عندما لا يوجد قيد معروف؛ وتكون القيمة حينها قائمة فارغة []	–	كما في الأعلى
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	الحصة غير المحلولة بالنسبة المئوية، محسوبة حتى الشركة المطلوبة. وقد تكون 0.	`0`	كما في الأعلى
ubos.unresolved_beneficial_owners[].viaarray	الشركات التي تمر بها السلسلة حتى هنا، أولًا الشريك المباشر للشركة المطلوبة.فارغ عندما الحصة غير المحلولة مملوكة مباشرةً في الشركة المطلوبة	–	كما في الأعلى
ubos.unresolved_beneficial_owners[].via[].depthinteger	المستوى: 1 شريك مباشر للشركة المطلوبة. وبجانبه اسم الشركة والـ entity_id الخاص بها.	`1`	كما في الأعلى
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	الحصة بالنسبة المئوية في هذا المستوى.	`94.5`	كما في الأعلى
ubos.coverageobject	كم من رأس المال رُدّ إلى أشخاص وكم يبقى مفتوحًا. ولا يبلغ مجموع القيمتين 100 دائمًا.	–	كما في الأعلى
ubos.coverage.resolved_percentagenumber	ما رُدّ إلى أشخاص، بالنسبة المئوية.	`5.5`	كما في الأعلى
ubos.coverage.unresolved_percentagenumber	ما لم يُردّ إلى أشخاص، بالنسبة المئوية.	`0`	كما في الأعلى

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "ubos": {5    "beneficial_owners": [6      {7        "person": {8          "entity_id": "08ed5f967956831ca6588930fd2693ed",9          "name": "Max Felix Mustermann",10          "birth_date": "1976-01-15",11          "name_parts": {12            "given": "Max Felix",13            "family": "Mustermann",14            "canonical_name": "Mustermann, Max Felix"15          },16          "location": {17            "home": {18              "city": "Musterheim",19              "county": "Musterheim (Landkreis)",20              "state": "Bayern",21              "country": "DEU"22            }23          }24        },25        "ownership_percentage": 5.5,26        "paths": [27          {28            "percentage": 5.5,29            "via": []30          }31        ]32      }33    ],34    "unresolved_beneficial_owners": [35      {36        "reason": "cycle",37        "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",38        "name": "ENSoXX Holding AG",39        "legal_form": "AG",40        "address": {41          "house_number": "25",42          "street": "Industriestraße",43          "postal_code": "91710",44          "city": "Gunzenhausen",45          "county": "Weißenburg-Gunzenhausen",46          "state": "Bayern",47          "country": "DEU",48          "coordinates": {49            "latitude": 49.12483,50            "longitude": 10.7805251          }52        },53        "registration": {54          "court": "Ansbach",55          "register_type": "HRB",56          "register_number": "6211"57        },58        "ownership_percentage": 0,59        "via": [60          {61            "depth": 1,62            "name": "ENSoXX GmbH",63            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",64            "step_percentage": 94.565          },66          {67            "depth": 2,68            "name": "ENSoXX Holding AG",69            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",70            "step_percentage": 10071          }72        ]73      },74      {75        "reason": "unknown",76        "entity_id": null,77        "name": null,78        "legal_form": null,79        "address": [],80        "registration": [],81        "ownership_percentage": 0,82        "via": [83          {84            "depth": 1,85            "name": "ENSoXX GmbH",86            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",87            "step_percentage": 94.588          },89          {90            "depth": 2,91            "name": "ENSoXX Holding AG",92            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",93            "step_percentage": 10094          }95        ]96      },97      {98        "reason": "unknown",99        "entity_id": null,100        "name": null,101        "legal_form": null,102        "address": [],103        "registration": [],104        "ownership_percentage": 0,105        "via": [106          {107            "depth": 1,108            "name": "ENSoXX GmbH",109            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",110            "step_percentage": 94.5111          },112          {113            "depth": 2,114            "name": "ENSoXX Holding AG",115            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",116            "step_percentage": 100117          }118        ]119      }120    ],121    "coverage": {122      "resolved_percentage": 5.5,123      "unresolved_percentage": 0124    }125  }126}

200 · مثال على استجابة: Hetzner Online GmbH مع الميزة ubos. في طلبنا النموذجي كان شخص واحد في beneficial_owners بنسبة 5.5%. وانتهت السلسلة عبر ENSoXX GmbH، Ansbach HRB 6105، في unresolved_beneficial_owners بالسببين cycle و unknown.

نحسب البيانات من قوائم الشركاء. أما بيانات المستفيدين الحقيقيين من Transparenzregister (سجل الشفافية) فلم تعد متاحة للعموم منذ نهاية 2022.

المشاركات

تُظهر الميزة shareholdings الاتجاه الآخر: في أي شركات تملك الشركة المطلوبة حصصًا. تأتي المشاركات من قوائم الشركاء لتلك الشركات. تكلّف 5 رصيد عندما توجد مشاركات.

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=shareholdings'

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": ["shareholdings"],
    },
)
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", "shareholdings");

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

الحقل
الحقل	المعنى	مثال	التوفر
shareholdingsobject\|null	الشركات التي تملك الشركة المطلوبة حصصًا فيها.فارغ عندما لا توجد مشاركة معروفة`shareholdings` · Beta	–	غالبًا: AG, SE, KGaA أحيانًا: GmbH, UG نادرًا: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	المشاركات الحالية، واحدة لكل شركة.	–	كما في الأعلى
shareholdings.holdings.current[].organizationobject	الشركة التي تُملك فيها الحصص.	–	كما في الأعلى
shareholdings.holdings.current[].organization.entity_idstring	معرّف الشركة، لملف الشركة الخاص بها.	`"63529c3a793e9f002196b4fd344e1241"`	كما في الأعلى
shareholdings.holdings.current[].organization.namestring\|null	اسم الشركة.	`"Hetzner Cloud GmbH"`	كما في الأعلى
shareholdings.holdings.current[].organization.legal_formstring\|null	الشكل القانوني للشركة.	`"GmbH"`	كما في الأعلى
shareholdings.holdings.current[].organization.statusstring\|null	حالة الشركة في السجل، مثل ACTIVE.	`"ACTIVE"`	كما في الأعلى
shareholdings.holdings.current[].organization.addressobject\|array	عنوان الشركة، بالبنية نفسها التي لـ address في البيانات الأساسية.فارغ عندما لا يوجد عنوان معروف؛ وتكون القيمة حينها قائمة فارغة []	–	كما في الأعلى
shareholdings.holdings.current[].organization.registrationobject\|array	قيد الشركة في السجل مع court وregister_type وregister_number.فارغ عندما لا يوجد قيد معروف؛ وتكون القيمة حينها قائمة فارغة []	–	كما في الأعلى
shareholdings.holdings.current[].ownership.percentagenumber\|null	الحصة بالنسبة المئوية: 100 تعني 100 %.فارغ عندما لا تُظهر القائمة حصة	`100`	كما في الأعلى
shareholdings.holdings.current[].ownership.contributionobject	المبلغ الاسمي للحصص مع amount وcurrency.	–	كما في الأعلى
shareholdings.holdings.current[].as_ofstring	تاريخ قائمة الشركاء التي جاءت منها المشاركة.	`"2017-09-19"`	كما في الأعلى
shareholdings.summary.total_currentinteger	عدد المشاركات الحالية.	`2`	كما في الأعلى

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholdings": {5    "holdings": {6      "current": [7        {8          "organization": {9            "entity_id": "63529c3a793e9f002196b4fd344e1241",10            "name": "Hetzner Cloud GmbH",11            "status": "ACTIVE",12            "legal_form": "GmbH",13            "address": {14              "house_number": "12A",15              "street": "Feringastraße",16              "postal_code": "85774",17              "city": "Unterföhring",18              "county": "München (Landkreis)",19              "state": "Bayern",20              "country": "DEU",21              "coordinates": {22                "latitude": 48.17815,23                "longitude": 11.6348724              }25            },26            "registration": {27              "court": "München",28              "register_type": "HRB",29              "register_number": "226782"30            }31          },32          "ownership": {33            "percentage": 100,34            "contribution": {35              "amount": 25000,36              "currency": "EUR"37            }38          },39          "as_of": "2017-09-19"40        },41        {42          "organization": {43            "entity_id": "997f1b8314b8b56573208ae2334abb1d",44            "name": "possum Projekt 1 GmbH",45            "status": "ACTIVE",46            "legal_form": "GmbH",47            "address": {48              "house_number": "169-173",49              "street": "Meisenburgstraße",50              "postal_code": "45133",51              "city": "Essen",52              "county": "Essen",53              "state": "Nordrhein-Westfalen",54              "country": "DEU",55              "coordinates": {56                "latitude": 51.40102,57                "longitude": 6.9580558              }59            },60            "registration": {61              "court": "Essen",62              "register_type": "HRB",63              "register_number": "35604"64            }65          },66          "ownership": {67            "percentage": 100,68            "contribution": {69              "amount": 25000,70              "currency": "EUR"71            }72          },73          "as_of": "2026-08-18"74        }75      ]76    },77    "summary": {78      "total_current": 279    }80  }81}

200 · مثال على استجابة: Hetzner Online GmbH مع الميزة shareholdings

مشاركات الشخص موجودة في ملف الشخص، بالميزة نفسها.

هياكل المجموعات

تجمّع روابط المجموعة من عدة نقاط بيانات. يُظهر shareholders وshareholdings المشاركات مستوى واحدًا للأعلى وللأسفل، وubos الأشخاص في نهاية السلسلة.

تربط شبكة الشركة الشركات والأشخاص عبر مستويين. وتشمل أيضًا الشركات المرتبطة.

الاندماجات والانقسامات والتحولات الأخرى موجودة تحت الاندماج والاستحواذ.