LEI इकाई लुकअप API
GLEIF रजिस्ट्री में LEI कोड या नाम से किसी विधिक इकाई की पहचान करें। आधिकारिक वैधानिक नाम, पते, अधिकार-क्षेत्र, राष्ट्रीय कंपनी रजिस्टर संख्या, BIC कोड और मूल कंपनी व सहायक कंपनियों के संबंध।
API key नहीं है?
अपनी API keys बनाने और मैनेज करने के लिए अपने खाते में साइन इन करें।
इंटीग्रेशन गाइड
एक snippet कॉपी करें, अपनी API key बदलें, रन करें। किसी भी HTTP क्लाइंट में काम करता है — नीचे cURL, JavaScript और Python में उदाहरण।
/api/lei-lookuphttps://www.apipick.comResolve 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"{
"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
}वास्तविक उपयोग के मामलों के लिए बनाया गया
इकाई पहचान
CRM में बिखरे हुए कंपनी नाम को एक ऐसे मानक पहचानकर्ता में बदलें जो सिस्टमों और अधिकार-क्षेत्रों के बीच साफ़-साफ़ जुड़ता है।
प्रतिपक्ष KYC
किसी प्रतिपक्ष का पंजीकृत वैधानिक नाम, अधिकार-क्षेत्र और राष्ट्रीय रजिस्टर संख्या आधिकारिक स्रोत से मिलाकर पुष्ट करें।
स्वामित्व का मानचित्रण
ऋण देने या अनुबंध पर हस्ताक्षर करने से पहले मूल और सहायक कंपनियों की कड़ियाँ देखकर पता लगाएँ कि इकाई पर अंततः नियंत्रण किसका है।
शोध एजेंट
शोध एजेंट को ऐसा पहचान-स्रोत दें जिसका संदर्भ दिया जा सके, ताकि उसके उत्तर में इकाइयों संबंधी दावे अनुमान के बजाय रजिस्ट्री तक जाएँ।
प्रतिक्रिया फ़ील्ड
| फ़ील्ड | प्रकार | विवरण |
|---|---|---|
| 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 | इस request के लिए काटे गए credits |
| remaining_credits | integer | आपके अकाउंट में शेष credits |
Rate limits
थ्रॉटलिंग प्रति API key है, 60-सेकंड की स्लाइडिंग विंडो। लिमिट पार करने पर आपको Retry-After हेडर के साथ साफ़ 429 मिलता है।
30req/min
प्रति API key, प्रति endpoint। 60-सेकंड की स्लाइडिंग विंडो।
3concurrent
प्रति API key अधिकतम एक साथ चल रहे requests।
X-RateLimit-Limitप्रति मिनट अनुमत अधिकतम requestsX-RateLimit-Remainingमौजूदा विंडो में शेष requestsX-RateLimit-Resetमौजूदा विंडो रीसेट होने में सेकंडRetry-Afterपुनः प्रयास से पहले प्रतीक्षा के सेकंड (केवल 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 यानी Global Legal Entity Identifier Foundation से आते हैं, जो Regulatory Oversight Committee की ओर से LEI रजिस्ट्री संचालित करती है। GLEIF स्तर 1 के संदर्भ डेटा और स्तर 2 के स्वामित्व डेटा, दोनों को CC0 के अंतर्गत प्रकाशित करती है — सार्वजनिक डोमेन, न श्रेय देना अनिवार्य और न आगे के उपयोग पर कोई रोक।
अक्सर पूछे जाने वाले प्रश्न
प्र: LEI क्या है और इसे कुंजी के रूप में क्यों उपयोग करें?
उ: Legal Entity Identifier 20 अक्षरों का ISO 17442 कोड है जो दुनिया भर में एक ही विधिक इकाई की पहचान करता है — विनियमित वित्तीय बाज़ारों में कारोबार करने वाले हर पक्ष के लिए अनिवार्य। कंपनी के नाम के विपरीत यह अस्पष्ट नहीं होता, और राष्ट्रीय रजिस्टर संख्या के विपरीत अलग-अलग अधिकार-क्षेत्रों में टकराता नहीं, इसलिए यही सही जोड़ने वाली कुंजी है।
प्र: क्या LEI जाने बिना भी खोज सकते हैं?
उ: हाँ। lei के बजाय name भेजें और रजिस्ट्री को वैधानिक नाम से खोजें, चाहें तो country से दायरा घटाएँ। GLEIF का नाम फ़िल्टर सटीक मिलान नहीं बल्कि प्रासंगिकता आधारित मिलान है, इसलिए total_matches बड़ा हो सकता है — लौटाए गए अभिलेख उस क्रम के शीर्ष हिस्से से होते हैं।
प्र: समूह की स्वामित्व संरचना कैसे मिलेगी?
उ: LEI से की गई क्वेरी में include_relationships=true जोड़ें। आपको प्रत्यक्ष मूल कंपनी, अंतिम मूल कंपनी और प्रत्यक्ष सहायक कंपनियों की संख्या मिलेगी, और हर मूल कंपनी अपने LEI से पहचानी जाती है, जिससे आगे की कॉल से आप संरचना में ऊपर या नीचे जा सकते हैं।
प्र: डेटा कितना ताज़ा है?
उ: GLEIF रजिस्ट्री की नई गोल्डन कॉपी प्रतिदिन प्रकाशित करती है, और यह एंडपॉइंट किसी स्थानीय स्नैपशॉट के बजाय उनके लाइव API को क्वेरी करता है। इकाइयों को हर वर्ष LEI नवीनीकृत कराना होता है, इसलिए registration_status और next_renewal_date बताते हैं कि अभिलेख सक्रिय रूप से बनाए रखा जा रहा है या समाप्त हो चुका है।
प्र: क्या डेटा को स्वतंत्र रूप से पुनर्वितरित किया जा सकता है?
उ: GLEIF, LEI संदर्भ डेटा को CC0 के अंतर्गत सार्वजनिक डोमेन में प्रकाशित करती है, आगे के उपयोग पर कोई लाइसेंस प्रतिबंध नहीं। इकाई डेटा के क्षेत्र में यह असामान्य है और यही इस एंडपॉइंट के होने का कारण है — वही जानकारी किसी व्यावसायिक विक्रेता से लेने पर प्रायः पुनर्वितरण की शर्तें साथ आती हैं।