What is an LEI and why use it as a key?

A Legal Entity Identifier is a 20-character ISO 17442 code that identifies one legal entity worldwide — required for anyone trading in regulated financial markets. Unlike a company name it is unambiguous, and unlike a national register number it does not collide across jurisdictions, which makes it the right join key for entity resolution.

Can I search without knowing the LEI?

Yes. Pass name instead of lei to search the register by legal name, optionally narrowed with country. GLEIF's name filter is a relevance match rather than an exact one, so total_matches can be large — the returned records are the ranked head of that list.

How do I get the corporate ownership tree?

Add include_relationships=true to an LEI lookup. You get the direct parent, the ultimate parent, and a count of direct subsidiaries, each parent identified by its own LEI so you can walk the tree upward or downward with further calls.

How current is the data?

GLEIF publishes a new golden copy of the register daily, and this endpoint queries their live API rather than a local snapshot. Entities must renew their LEI annually, so registration_status and next_renewal_date tell you whether a record is actively maintained or has lapsed.

Is the data free to redistribute?

GLEIF publishes the LEI reference data under CC0, into the public domain, with no licensing restriction on downstream use. That is unusual for entity data and is why this endpoint exists — the same lookup from a commercial vendor typically comes with redistribution terms attached.

[ الأعمال · الكيانات ]● 3 أرصدة · 30 طلبًا/دقيقة

البحث عن كيان قانوني بمعرّف LEI

حدِّد كيانًا قانونيًا في سجل GLEIF برمز LEI أو بالاسم. الاسم القانوني الرسمي والعناوين والاختصاص القضائي ورقم السجل التجاري الوطني ورموز BIC وروابط الشركة الأم والشركات التابعة.

رسمي من GLEIFISO 17442CC0، ملكية عامة

auth · x-api-key

مفتاح API

لا تملك مفتاح API؟

سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.

تسجيل الدخول إدارة مفاتيح API

[ 02 · integrate ]

دليل التكامل

انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

المعاملات

leistringاختياري

20-character LEI code. Mutually exclusive with name. HWUPKR0MPOU8FGXBT394

namestringاختياري

Legal entity name to search for. Mutually exclusive with lei. Tesla, Inc.

countrystringاختياري

ISO 3166-1 alpha-2 code narrowing a name search. US

include_relationshipsbooleanاختياري

With lei, also return direct parent, ultimate parent, and subsidiary count. true

curl -X GET "https://www.apipick.com/api/lei-lookup" \
  -H "x-api-key: YOUR_API_KEY"

● 200 · الاستجابة

{
  "mode": "lei",
  "query": "HWUPKR0MPOU8FGXBT394",
  "found": true,
  "record": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legal_name": "Apple Inc.",
    "other_names": [
      "Apple Computer, Inc."
    ],
    "legal_address": {
      "lines": [
        "C/O C T Corporation System",
        "330 N. Brand Blvd"
      ],
      "city": "Glendale",
      "region": "US-CA",
      "country": "US",
      "postal_code": "91203"
    },
    "jurisdiction": "US-CA",
    "legal_form": "H1UM",
    "entity_status": "ACTIVE",
    "registered_as": "806592",
    "bic": [
      "APLEUS66XXX"
    ],
    "registration_status": "ISSUED",
    "next_renewal_date": "2027-03-08T17:27:20Z"
  },
  "relationships": {
    "direct_parent": null,
    "ultimate_parent": null,
    "direct_children_count": 8
  },
  "source": "GLEIF",
  "credits_used": 3,
  "remaining_credits": 97
}

مبني لحالات استخدام واقعية

🔗

تحديد هوية الكيانات

حوِّل اسم شركة غير موحَّد في نظام إدارة العملاء إلى مُعرِّف قياسي واحد يربط البيانات بنظافة عبر الأنظمة والاختصاصات القضائية.

🏛️

اعرف عميلك للأطراف المقابلة

أكِّد الاسم القانوني المسجَّل للطرف المقابل واختصاصه القضائي ورقم سجله التجاري الوطني مقابل مصدر رسمي.

🌳

رسم خريطة الملكية

تتبّع روابط الشركات الأم والتابعة لتعرف من يسيطر فعليًا على الكيان قبل منح ائتمان أو توقيع عقد.

🤖

وكلاء البحث

امنح وكيل البحث مصدر هوية يمكن الاستشهاد به، فتعود الادعاءات المتعلقة بالكيانات في مخرجاته إلى سجل رسمي لا إلى تخمين.

حقول الاستجابة

الحقل	النوع	الوصف
mode	string	نوع الاستعلام المُنفَّذ: lei أو search
record.lei	string	المُعرِّف المكوَّن من 20 حرفًا وفق ISO 17442
record.legal_name	string \| null	الاسم القانوني الرسمي المسجَّل
record.other_names	string[]	الأسماء السابقة والبديلة المدوَّنة في السجل
record.legal_address	object \| null	العنوان القانوني، مقسَّمًا إلى أسطر ومدينة ومنطقة ودولة ورمز بريدي
record.jurisdiction	string \| null	اختصاص التأسيس، مثل US-CA
record.registered_as	string \| null	الرقم في السجل التجاري الوطني — الجسر إلى الإفصاحات المحلية
record.entity_status	string \| null	ACTIVE أو INACTIVE
record.bic	string[]	رموز SWIFT/BIC المرتبطة، إن وُجدت للكيان
record.registration_status	string \| null	حالة دورة حياة معرّف LEI، مثل ISSUED أو LAPSED
relationships	object	يظهر مع include_relationships: الشركة الأم المباشرة والنهائية وعدد الشركات التابعة
total_matches	integer	في وضع البحث فقط: عدد السجلات المطابقة للاسم
credits_used	integer	الأرصدة المخصومة عن هذا الطلب
remaining_credits	integer	الأرصدة المتبقية في حسابك

[ 03 · limits ]

حدود المعدل

يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.

معدل الطلبات

30req/min

لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.

التزامن

3concurrent

الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.

ترويسات الاستجابة

X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقة

X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية

X-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحالية

Retry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)

● 429 · طلبات كثيرة جدًا

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

مصدر البيانات والترخيص

تأتي السجلات من GLEIF، مؤسسة معرّف الكيان القانوني العالمي، التي تدير سجل LEI نيابةً عن لجنة الرقابة التنظيمية. وتنشر GLEIF بيانات المستوى الأول المرجعية وبيانات الملكية من المستوى الثاني بترخيص CC0 — ملكية عامة، دون اشتراط نسبٍ ودون أي قيد على الاستخدام اللاحق.

الأسئلة الشائعة

س: ما معرّف LEI ولماذا يُستخدم مفتاحًا للربط؟

ج: معرّف الكيان القانوني رمز من 20 حرفًا وفق ISO 17442 يحدّد كيانًا قانونيًا واحدًا على مستوى العالم، ويُلزَم به كل من يتداول في الأسواق المالية المنظَّمة. وهو، بخلاف اسم الشركة، لا يحتمل اللبس، وبخلاف رقم السجل الوطني لا يتعارض بين الاختصاصات القضائية، ما يجعله المفتاح المناسب لربط بيانات الكيانات.

س: هل يمكنني البحث دون معرفة معرّف LEI؟

ج: نعم. مرِّر name بدل lei للبحث في السجل بالاسم القانوني، مع إمكانية التضييق عبر country. ومرشِّح الاسم لدى GLEIF مطابقة بحسب الصلة لا مطابقة تامة، لذا قد تكون قيمة total_matches كبيرة — والسجلات المُعادة هي صدارة تلك القائمة.

س: كيف أحصل على هيكل ملكية المجموعة؟

ج: أضف include_relationships=true إلى استعلام معرّف LEI. ستحصل على الشركة الأم المباشرة والشركة الأم النهائية وعدد الشركات التابعة المباشرة، وكل شركة أم مُعرَّفة بمعرّف LEI خاص بها، فتستطيع تتبّع الشجرة صعودًا أو نزولًا باستدعاءات لاحقة.

س: ما مدى حداثة البيانات؟

ج: تنشر GLEIF نسخة مرجعية جديدة من السجل يوميًا، وهذه الواجهة تستعلم من واجهتهم الحيّة لا من نسخة محلية. وعلى الكيانات تجديد معرّف LEI سنويًا، لذا يخبرك registration_status وnext_renewal_date بما إذا كان السجل مُحدَّثًا فعليًا أم انقضت صلاحيته.

س: هل يمكن إعادة توزيع البيانات بحرية؟

ج: تنشر GLEIF بيانات LEI المرجعية بترخيص CC0 في الملكية العامة، دون أي قيد ترخيصي على الاستخدام اللاحق. وهذا أمر غير معتاد في بيانات الكيانات، وهو تحديدًا سبب وجود هذه الواجهة — إذ عادةً ما يأتي الاستعلام نفسه من مزوّد تجاري محمَّلًا بشروط لإعادة التوزيع.