[ व्यवसाय · इकाई ]● 3 क्रेडिट · 30 अनुरोध/मिनट

LEI इकाई लुकअप API

GLEIF रजिस्ट्री में LEI कोड या नाम से किसी विधिक इकाई की पहचान करें। आधिकारिक वैधानिक नाम, पते, अधिकार-क्षेत्र, राष्ट्रीय कंपनी रजिस्टर संख्या, BIC कोड और मूल कंपनी व सहायक कंपनियों के संबंध।

GLEIF आधिकारिकISO 17442CC0 सार्वजनिक डोमेन
auth · x-api-key

API key नहीं है?

अपनी API keys बनाने और मैनेज करने के लिए अपने खाते में साइन इन करें।

[ 02 · integrate ]

इंटीग्रेशन गाइड

एक snippet कॉपी करें, अपनी API key बदलें, रन करें। किसी भी HTTP क्लाइंट में काम करता है — नीचे cURL, JavaScript और Python में उदाहरण।

spec
GET/api/lei-lookup
base
https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parameters
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 · response
{
  "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

किसी प्रतिपक्ष का पंजीकृत वैधानिक नाम, अधिकार-क्षेत्र और राष्ट्रीय रजिस्टर संख्या आधिकारिक स्रोत से मिलाकर पुष्ट करें।

🌳

स्वामित्व का मानचित्रण

ऋण देने या अनुबंध पर हस्ताक्षर करने से पहले मूल और सहायक कंपनियों की कड़ियाँ देखकर पता लगाएँ कि इकाई पर अंततः नियंत्रण किसका है।

🤖

शोध एजेंट

शोध एजेंट को ऐसा पहचान-स्रोत दें जिसका संदर्भ दिया जा सके, ताकि उसके उत्तर में इकाइयों संबंधी दावे अनुमान के बजाय रजिस्ट्री तक जाएँ।

प्रतिक्रिया फ़ील्ड

फ़ील्डप्रकारविवरण
modestringकौन-सी क्वेरी चली: lei या search
record.leistring20 अक्षरों का ISO 17442 पहचानकर्ता
record.legal_namestring | nullआधिकारिक रूप से पंजीकृत वैधानिक नाम
record.other_namesstring[]अभिलेख में दर्ज पूर्व और वैकल्पिक नाम
record.legal_addressobject | nullपंजीकृत पता, पंक्तियों, शहर, क्षेत्र, देश और पिन कोड में विभाजित
record.jurisdictionstring | nullगठन का अधिकार-क्षेत्र, जैसे US-CA
record.registered_asstring | nullराष्ट्रीय कंपनी रजिस्टर में संख्या — स्थानीय अभिलेखों तक पहुँचने का सेतु
record.entity_statusstring | nullACTIVE या INACTIVE
record.bicstring[]संबद्ध SWIFT/BIC कोड, यदि इकाई के पास हों
record.registration_statusstring | nullLEI जीवनचक्र स्थिति, जैसे ISSUED या LAPSED
relationshipsobjectinclude_relationships के साथ आता है: प्रत्यक्ष मूल कंपनी, अंतिम मूल कंपनी और सहायक कंपनियों की संख्या
total_matchesintegerकेवल खोज मोड में: नाम से कितने अभिलेख मेल खाए
credits_usedintegerइस request के लिए काटे गए credits
remaining_creditsintegerआपके अकाउंट में शेष credits
[ 03 · limits ]

Rate limits

थ्रॉटलिंग प्रति API key है, 60-सेकंड की स्लाइडिंग विंडो। लिमिट पार करने पर आपको Retry-After हेडर के साथ साफ़ 429 मिलता है।

request rate

30req/min

प्रति API key, प्रति endpoint। 60-सेकंड की स्लाइडिंग विंडो।

concurrency

3concurrent

प्रति API key अधिकतम एक साथ चल रहे requests।

response headers
X-RateLimit-Limitप्रति मिनट अनुमत अधिकतम requests
X-RateLimit-Remainingमौजूदा विंडो में शेष requests
X-RateLimit-Resetमौजूदा विंडो रीसेट होने में सेकंड
Retry-Afterपुनः प्रयास से पहले प्रतीक्षा के सेकंड (केवल 429 पर)
● 429 · too many requests
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 के अंतर्गत सार्वजनिक डोमेन में प्रकाशित करती है, आगे के उपयोग पर कोई लाइसेंस प्रतिबंध नहीं। इकाई डेटा के क्षेत्र में यह असामान्य है और यही इस एंडपॉइंट के होने का कारण है — वही जानकारी किसी व्यावसायिक विक्रेता से लेने पर प्रायः पुनर्वितरण की शर्तें साथ आती हैं।