LEI 法人实体查询 API
通过 GLEIF 注册库按 LEI 代码或名称解析法人实体，返回法定名称、地址、司法辖区、本国工商登记号、BIC 代码与母子公司关系。
集成指南
复制代码片段，替换你的 API 密钥，运行即可。适用于任何 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 | 本次请求扣除的积分 |
| remaining_credits | integer | 你账户中剩余的积分 |
速率限制
限流按 API 密钥计，采用 60 秒滑动窗口。触发限制时会返回干净的 429，并带 Retry-After 响应头。
30req/min
按 API 密钥、按端点计。60 秒滑动窗口。
3concurrent
每个 API 密钥的最大同时进行中请求数。
X-RateLimit-Limit每分钟允许的最大请求数X-RateLimit-Remaining当前窗口内剩余的请求数X-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，该机构受监管监督委员会委托维护 LEI 注册库。GLEIF 以 CC0 协议发布一级参考数据与二级股权数据 —— 属公共领域，无需署名，对下游使用也没有任何限制。
常见问题
问： 什么是 LEI？为什么适合当主键？
答： 法人识别编码是一个 20 位的 ISO 17442 代码，在全球范围内唯一标识一个法人实体 —— 凡在受监管金融市场交易者均须持有。它不像公司名称那样存在歧义，也不像本国登记号那样会跨辖区重号，因此是实体解析中最合适的关联主键。
问： 不知道 LEI 能查吗？
答： 可以。用 name 代替 lei 即可按法定名称搜索注册库，还能用 country 进一步收窄。GLEIF 的名称过滤是相关性匹配而非精确匹配，因此 total_matches 可能很大 —— 返回的记录是该列表中排序靠前的部分。
问： 怎么获取集团股权结构？
答： 在按 LEI 查询时加上 include_relationships=true。你会拿到直接母公司、最终母公司以及直接子公司数量，且每个母公司都以自己的 LEI 标识，便于你再发起调用沿着树状结构向上或向下遍历。
问： 数据有多新？
答： GLEIF 每日发布一份新的注册库黄金副本，而本接口查询的是他们的在线 API，而非本地快照。实体必须每年续期 LEI，因此 registration_status 与 next_renewal_date 能告诉你某条记录是仍在积极维护，还是已经失效。
问： 数据可以自由再分发吗？
答： GLEIF 以 CC0 协议把 LEI 参考数据置于公共领域，对下游使用没有任何授权限制。这在实体数据领域相当少见，也正是这个接口存在的理由 —— 同样的查询若来自商业数据商，通常都会附带再分发条款。