Tra cứu pháp nhân theo LEI
Xác định một pháp nhân trong sổ đăng ký GLEIF theo mã LEI hoặc theo tên. Tên pháp lý chính thức, địa chỉ, thẩm quyền tài phán, số đăng ký doanh nghiệp quốc gia, mã BIC và quan hệ công ty mẹ — công ty con.
Chưa có API key?
Đăng nhập vào tài khoản để tạo và quản lý API key của bạn.
Hướng dẫn tích hợp
Sao chép một đoạn mã, thay API key của bạn, chạy. Hoạt động với mọi HTTP client — các ví dụ bên dưới bằng cURL, JavaScript và Python.
/api/lei-lookuphttps://www.apipick.comResolve a legal entity through the GLEIF LEI register
leistringtùy chọn20-character LEI code. Mutually exclusive with name. HWUPKR0MPOU8FGXBT394
namestringtùy chọnLegal entity name to search for. Mutually exclusive with lei. Tesla, Inc.
countrystringtùy chọnISO 3166-1 alpha-2 code narrowing a name search. US
include_relationshipsbooleantùy chọnWith 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
}Xây dựng cho các trường hợp sử dụng thực tế
Định danh pháp nhân
Biến một tên công ty ghi lộn xộn trong CRM thành một mã định danh chuẩn duy nhất, ghép nối gọn gàng giữa các hệ thống và các vùng tài phán.
KYC đối tác
Đối chiếu tên pháp lý đã đăng ký, thẩm quyền tài phán và số đăng ký quốc gia của đối tác với một nguồn chính thức.
Lập sơ đồ sở hữu
Lần theo quan hệ công ty mẹ và công ty con để biết ai thực sự kiểm soát một pháp nhân trước khi cấp tín dụng hoặc ký kết.
Tác tử nghiên cứu
Cấp cho tác tử nghiên cứu một nguồn định danh có thể trích dẫn, để mọi khẳng định về pháp nhân trong kết quả đều truy về sổ đăng ký thay vì phỏng đoán.
Các trường phản hồi
| Trường | Kiểu | Mô tả |
|---|---|---|
| mode | string | Kiểu tra cứu đã chạy: lei hoặc search |
| record.lei | string | Mã định danh ISO 17442 gồm 20 ký tự |
| record.legal_name | string | null | Tên pháp lý chính thức đã đăng ký |
| record.other_names | string[] | Tên cũ và tên thay thế được ghi nhận |
| record.legal_address | object | null | Địa chỉ đăng ký, tách theo dòng, thành phố, vùng, quốc gia và mã bưu chính |
| record.jurisdiction | string | null | Vùng tài phán thành lập, ví dụ US-CA |
| record.registered_as | string | null | Số trong sổ đăng ký doanh nghiệp quốc gia — cầu nối tới hồ sơ công bố tại nước sở tại |
| record.entity_status | string | null | ACTIVE hoặc INACTIVE |
| record.bic | string[] | Các mã SWIFT/BIC được liên kết, nếu pháp nhân có |
| record.registration_status | string | null | Trạng thái vòng đời của LEI, ví dụ ISSUED hoặc LAPSED |
| relationships | object | Xuất hiện khi dùng include_relationships: công ty mẹ trực tiếp, công ty mẹ sau cùng và số công ty con |
| total_matches | integer | Chỉ ở chế độ tìm kiếm: có bao nhiêu bản ghi khớp với tên |
| credits_used | integer | Credit bị trừ cho request này |
| remaining_credits | integer | Credit còn lại trong tài khoản của bạn |
Giới hạn tần suất
Giới hạn tốc độ tính theo từng API key, cửa sổ trượt 60 giây. Vượt giới hạn, bạn nhận được phản hồi 429 sạch sẽ kèm header Retry-After.
30req/min
Theo từng API key, từng endpoint. Cửa sổ trượt 60 giây.
3concurrent
Số request đang chạy tối đa đồng thời cho mỗi API key.
X-RateLimit-LimitSố request tối đa cho phép mỗi phútX-RateLimit-RemainingSố request còn lại trong cửa sổ hiện tạiX-RateLimit-ResetSố giây cho đến khi cửa sổ hiện tại được đặt lạiRetry-AfterSố giây cần chờ trước khi thử lại (chỉ khi 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
}Nguồn dữ liệu và giấy phép
Bản ghi đến từ GLEIF, Global Legal Entity Identifier Foundation, tổ chức vận hành sổ đăng ký LEI thay mặt Regulatory Oversight Committee. GLEIF phát hành cả dữ liệu tham chiếu cấp 1 lẫn dữ liệu sở hữu cấp 2 theo giấy phép CC0 — thuộc phạm vi công cộng, không bắt buộc ghi nguồn và không hạn chế việc sử dụng về sau.
Câu hỏi thường gặp
Hỏi: LEI là gì và vì sao nên dùng làm khóa?
Đáp: Legal Entity Identifier là mã ISO 17442 gồm 20 ký tự, định danh duy nhất một pháp nhân trên toàn cầu — bắt buộc với mọi chủ thể giao dịch trên thị trường tài chính có quản lý. Khác với tên công ty, nó không gây nhập nhằng; khác với số đăng ký quốc gia, nó không trùng lặp giữa các vùng tài phán, nên là khóa ghép nối phù hợp.
Hỏi: Tôi có thể tìm khi không biết mã LEI không?
Đáp: Được. Hãy truyền name thay cho lei để tìm trong sổ đăng ký theo tên pháp lý, và có thể thu hẹp thêm bằng country. Bộ lọc theo tên của GLEIF là so khớp theo mức liên quan chứ không phải khớp chính xác, nên total_matches có thể rất lớn — các bản ghi trả về là phần đầu của danh sách đã xếp hạng đó.
Hỏi: Làm sao lấy được sơ đồ sở hữu của tập đoàn?
Đáp: Thêm include_relationships=true vào truy vấn theo LEI. Bạn sẽ nhận được công ty mẹ trực tiếp, công ty mẹ sau cùng và số lượng công ty con trực tiếp, mỗi công ty mẹ đều có mã LEI riêng nên bạn có thể đi ngược lên hoặc xuôi xuống cây sở hữu bằng các lệnh gọi tiếp theo.
Hỏi: Dữ liệu mới đến mức nào?
Đáp: GLEIF công bố bản sao chuẩn mới của sổ đăng ký mỗi ngày, và endpoint này truy vấn API trực tiếp của họ chứ không phải một bản chụp cục bộ. Pháp nhân phải gia hạn LEI hằng năm, nên registration_status và next_renewal_date cho bạn biết bản ghi còn được duy trì hay đã hết hiệu lực.
Hỏi: Dữ liệu có được tự do phân phối lại không?
Đáp: GLEIF phát hành dữ liệu tham chiếu LEI theo giấy phép CC0, đưa vào phạm vi công cộng, không kèm bất kỳ hạn chế bản quyền nào đối với việc sử dụng về sau. Điều này khá hiếm với dữ liệu pháp nhân và chính là lý do endpoint này tồn tại — cùng một truy vấn từ nhà cung cấp thương mại thường đi kèm điều khoản phân phối lại.