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.

[ iş · tüzel kişi ]● 3 kredi · dakikada 30 istek

LEI tüzel kişi sorgusu API

GLEIF sicilinde bir tüzel kişiyi LEI koduna veya unvana göre tespit edin. Resmî ticari unvan, adresler, yargı yetkisi, ulusal ticaret sicil numarası, BIC kodları ve ana ortaklık ile bağlı ortaklık ilişkileri.

GLEIF resmîISO 17442CC0, kamu malı

auth · x-api-key

API Key

API key'iniz yok mu?

API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.

Oturum Aç API Key'leri Yönet

[ 02 · integrate ]

Entegrasyon rehberi

Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parametreler

leistringisteğe bağlı

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

namestringisteğe bağlı

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

countrystringisteğe bağlı

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

include_relationshipsbooleanisteğe bağlı

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 · yanıt

{
  "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
}

Gerçek Dünya Kullanım Senaryoları İçin Tasarlandı

🔗

Tüzel kişi eşleştirme

CRM'deki dağınık bir şirket unvanını, sistemler ve yargı bölgeleri arasında temiz biçimde eşleşen tek bir standart tanımlayıcıya dönüştürün.

🏛️

Muhatap KYC'si

Bir muhatabın kayıtlı ticari unvanını, yargı yetkisini ve ulusal sicil numarasını resmî bir kaynakla teyit edin.

🌳

Ortaklık yapısını çıkarma

Kredi vermeden veya sözleşme imzalamadan önce ana ortaklık ve bağlı ortaklık bağlarını izleyerek tüzel kişiyi nihai olarak kimin kontrol ettiğini görün.

🤖

Araştırma ajanları

Araştırma ajanına kaynak gösterilebilir bir kimlik verisi sağlayın; böylece çıktısındaki tüzel kişi bilgileri tahmine değil bir sicile dayansın.

Yanıt alanları

Alan	Tür	Açıklama
mode	string	Hangi sorgunun çalıştığı: lei veya search
record.lei	string	20 karakterlik ISO 17442 tanımlayıcısı
record.legal_name	string \| null	Resmî kayıtlı ticari unvan
record.other_names	string[]	Sicilde yer alan önceki ve alternatif unvanlar
record.legal_address	object \| null	Kayıtlı adres; satırlar, şehir, bölge, ülke ve posta koduna ayrılmış
record.jurisdiction	string \| null	Kuruluş yargı yetkisi, örn. US-CA
record.registered_as	string \| null	Ulusal ticaret sicilindeki numara — yerel bildirimlere açılan köprü
record.entity_status	string \| null	ACTIVE veya INACTIVE
record.bic	string[]	Tüzel kişiye eşlenmiş SWIFT/BIC kodları, varsa
record.registration_status	string \| null	LEI yaşam döngüsü durumu, örn. ISSUED veya LAPSED
relationships	object	include_relationships ile birlikte döner: doğrudan ana ortaklık, nihai ana ortaklık ve bağlı ortaklık sayısı
total_matches	integer	Yalnızca arama modunda: unvanla kaç kaydın eşleştiği
credits_used	integer	Bu istek için düşülen kredi
remaining_credits	integer	Hesabınızda kalan kredi

[ 03 · limits ]

Rate limit'ler

Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.

istek hızı

30req/min

API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.

eşzamanlılık

3concurrent

API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.

yanıt başlıkları

X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısı

X-RateLimit-RemainingMevcut penceredeki kalan istek sayısı

X-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniye

Retry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)

● 429 · çok fazla istek

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
}

Veri kaynağı ve lisans

Kayıtlar, LEI sicilini Regulatory Oversight Committee adına yürüten Global Legal Entity Identifier Foundation'dan (GLEIF) gelir. GLEIF hem 1. seviye referans verilerini hem de 2. seviye ortaklık verilerini CC0 ile yayımlar — kamu malıdır, atıf zorunluluğu yoktur ve sonraki kullanımda hiçbir kısıtlama getirmez.

Sıkça Sorulan Sorular

S: LEI nedir ve neden anahtar olarak kullanılır?

C: Legal Entity Identifier, dünya genelinde tek bir tüzel kişiyi tanımlayan 20 karakterlik bir ISO 17442 kodudur ve düzenlenmiş finansal piyasalarda işlem yapan herkes için zorunludur. Şirket unvanının aksine belirsizlik taşımaz, ulusal sicil numarasının aksine yargı bölgeleri arasında çakışmaz; bu da onu tüzel kişi eşleştirmede doğru bağlantı anahtarı yapar.

S: LEI'yi bilmeden arama yapabilir miyim?

C: Evet. Sicili ticari unvana göre aramak için lei yerine name gönderin; isterseniz country ile daraltın. GLEIF'in unvan filtresi tam eşleşme değil ilgi düzeyine göre eşleşmedir; bu yüzden total_matches büyük olabilir — dönen kayıtlar bu sıralamanın en üst kısmıdır.

S: Grup ortaklık yapısını nasıl alırım?

C: LEI sorgusuna include_relationships=true ekleyin. Doğrudan ana ortaklığı, nihai ana ortaklığı ve doğrudan bağlı ortaklık sayısını alırsınız; her ana ortaklık kendi LEI'siyle tanımlandığından ek çağrılarla ağaçta yukarı ya da aşağı ilerleyebilirsiniz.

S: Veriler ne kadar güncel?

C: GLEIF sicilin yeni referans kopyasını her gün yayımlar ve bu uç nokta yerel bir anlık görüntüyü değil onların canlı API'sini sorgular. Tüzel kişilerin LEI'lerini her yıl yenilemesi gerektiğinden registration_status ve next_renewal_date, bir kaydın etkin biçimde sürdürülüp sürdürülmediğini gösterir.

S: Veriler serbestçe yeniden dağıtılabilir mi?

C: GLEIF, LEI referans verilerini CC0 ile kamu malı olarak yayımlar ve sonraki kullanım için hiçbir lisans kısıtlaması getirmez. Tüzel kişi verilerinde bu alışılmadıktır ve bu uç noktanın var olma nedeni tam da budur — aynı sorgu ticari bir sağlayıcıdan alındığında genellikle yeniden dağıtım koşullarıyla birlikte gelir.