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 법인 조회 API

GLEIF 등록부에서 LEI 코드 또는 이름으로 법인을 식별합니다. 공식 법인명, 주소, 관할권, 자국 상업등기 번호, BIC 코드, 모회사·자회사 관계를 반환합니다.

GLEIF 공식ISO 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
}

실전 활용 사례를 위해 제작

🔗

법인 식별

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	이 요청으로 차감된 크레딧
remaining_credits	integer	계정에 남은 크레딧

[ 03 · limits ]

요청 제한

스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.

요청 속도

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
}

데이터 출처 및 라이선스

레코드는 규제감독위원회의 위임을 받아 LEI 등록부를 운영하는 Global Legal Entity Identifier Foundation(GLEIF)에서 가져옵니다. GLEIF는 레벨 1 참조 데이터와 레벨 2 지배구조 데이터를 모두 CC0로 공개합니다 —— 퍼블릭 도메인이며 출처 표시 의무도, 후속 이용 제한도 없습니다.

자주 묻는 질문

Q: LEI란 무엇이며 왜 키로 쓰나요?

A: LEI(법인 식별자)는 전 세계에서 하나의 법인을 식별하는 20자리 ISO 17442 코드로, 규제 대상 금융시장에서 거래하는 주체에게 의무화되어 있습니다. 회사 이름과 달리 모호하지 않고, 자국 등기 번호와 달리 관할권을 넘어 중복되지 않아 법인 식별의 결합 키로 적합합니다.

Q: LEI를 모르는 상태에서도 검색할 수 있나요?

A: 가능합니다. lei 대신 name을 넘기면 법인명으로 등록부를 검색할 수 있고, country로 범위를 좁힐 수 있습니다. GLEIF의 이름 필터는 정확 일치가 아니라 관련도 일치라서 total_matches가 클 수 있으며, 반환되는 레코드는 그 목록의 상위입니다.

Q: 기업집단 지배구조는 어떻게 얻나요?

A: LEI 조회에 include_relationships=true를 추가하세요. 직접 모회사, 최종 모회사, 직접 자회사 수를 얻으며 각 모회사는 자체 LEI로 식별되므로 추가 호출로 트리를 위아래로 따라갈 수 있습니다.

Q: 데이터는 얼마나 최신인가요?

A: GLEIF는 매일 새로운 등록부 골든 카피를 공개하며, 이 엔드포인트는 로컬 스냅숏이 아니라 그들의 라이브 API를 조회합니다. 법인은 LEI를 매년 갱신해야 하므로 registration_status와 next_renewal_date를 보면 그 레코드가 현재도 관리되고 있는지 만료되었는지 알 수 있습니다.

Q: 데이터를 자유롭게 재배포할 수 있나요?

A: GLEIF는 LEI 참조 데이터를 CC0로 퍼블릭 도메인에 두었으며 후속 이용에 라이선스 제한이 전혀 없습니다. 법인 데이터로서는 이례적인 일이며, 바로 이 점이 이 엔드포인트가 존재하는 이유입니다 —— 같은 조회를 상용 벤더에서 받으면 대개 재배포 조건이 따라붙습니다.