ค้นหานิติบุคคล ด้วย LEI API
ระบุตัวนิติบุคคลในทะเบียน GLEIF ด้วยรหัส LEI หรือชื่อ ชื่อทางกฎหมายอย่างเป็นทางการ ที่อยู่ เขตอำนาจศาล เลขทะเบียนบริษัทในประเทศ รหัส BIC และความสัมพันธ์บริษัทแม่กับบริษัทลูก
ยังไม่มี API Key?
เข้าสู่ระบบบัญชีของคุณเพื่อสร้างและจัดการ API Key
คู่มือการผสานรวม
คัดลอกสนิปเพ็ต แทนที่ API key ของคุณ แล้วรัน ใช้ได้กับ HTTP client ทุกตัว — ตัวอย่างด้านล่างเป็น 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 | รหัสระบุตัวตนตาม ISO 17442 ความยาว 20 อักขระ |
| 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 | เครดิตที่เหลือในบัญชีของคุณ |
Rate limit
การจำกัดอัตราเป็นแบบต่อ API key ในหน้าต่างเลื่อน 60 วินาที เมื่อถึงขีดจำกัดคุณจะได้ 429 ที่สะอาดพร้อม header Retry-After
30req/min
ต่อ API key ต่อ endpoint หน้าต่างเลื่อน 60 วินาที
3concurrent
จำนวนคำขอที่กำลังดำเนินการพร้อมกันได้สูงสุดต่อ API key
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 หรือ Global Legal Entity Identifier Foundation ซึ่งดูแลทะเบียน LEI ในนามของ Regulatory Oversight Committee GLEIF เผยแพร่ทั้งข้อมูลอ้างอิงระดับ 1 และข้อมูลการถือหุ้นระดับ 2 ภายใต้ CC0 — เป็นสาธารณสมบัติ ไม่บังคับให้ระบุที่มา และไม่มีข้อจำกัดในการนำไปใช้ต่อ
คำถามที่พบบ่อย
ถาม: LEI คืออะไร และทำไมจึงใช้เป็นคีย์
ตอบ: Legal Entity Identifier คือรหัสตาม ISO 17442 ความยาว 20 อักขระ ที่ระบุนิติบุคคลหนึ่งรายได้ทั่วโลก และเป็นข้อบังคับสำหรับผู้ที่ทำธุรกรรมในตลาดการเงินที่มีการกำกับดูแล ต่างจากชื่อบริษัทตรงที่ไม่คลุมเครือ และต่างจากเลขทะเบียนในประเทศตรงที่ไม่ซ้ำกันข้ามเขตอำนาจศาล จึงเป็นคีย์เชื่อมโยงที่เหมาะสม
ถาม: ถ้าไม่ทราบรหัส LEI จะค้นหาได้ไหม
ตอบ: ได้ ส่ง name แทน lei เพื่อค้นทะเบียนด้วยชื่อทางกฎหมาย และจะจำกัดขอบเขตเพิ่มด้วย country ก็ได้ ตัวกรองชื่อของ GLEIF เป็นการจับคู่ตามความเกี่ยวข้อง ไม่ใช่การจับคู่แบบตรงตัว ค่า total_matches จึงอาจสูงมาก ส่วนรายการที่คืนมาคือกลุ่มบนสุดของลำดับนั้น
ถาม: จะดูโครงสร้างกลุ่มบริษัทได้อย่างไร
ตอบ: เพิ่ม include_relationships=true ลงในคำค้นแบบ LEI คุณจะได้บริษัทแม่โดยตรง บริษัทแม่ลำดับสูงสุด และจำนวนบริษัทลูกโดยตรง โดยบริษัทแม่แต่ละรายระบุด้วย LEI ของตนเอง คุณจึงไล่ขึ้นหรือลงตามโครงสร้างได้ด้วยการเรียกเพิ่ม
ถาม: ข้อมูลใหม่แค่ไหน
ตอบ: GLEIF เผยแพร่สำเนาอ้างอิงของทะเบียนชุดใหม่ทุกวัน และเอนด์พอยต์นี้สอบถาม API สดของพวกเขา ไม่ใช่สแนปช็อตในเครื่อง นิติบุคคลต้องต่ออายุ LEI ทุกปี ดังนั้น registration_status และ next_renewal_date จะบอกคุณว่าข้อมูลนั้นยังได้รับการดูแลอยู่หรือหมดอายุไปแล้ว
ถาม: นำข้อมูลไปเผยแพร่ต่อได้อย่างอิสระหรือไม่
ตอบ: GLEIF เผยแพร่ข้อมูลอ้างอิง LEI ภายใต้ CC0 ให้เป็นสาธารณสมบัติ โดยไม่มีข้อจำกัดด้านสัญญาอนุญาตต่อการนำไปใช้ต่อเลย ซึ่งถือว่าไม่ธรรมดาสำหรับข้อมูลนิติบุคคล และนั่นคือเหตุผลที่เอนด์พอยต์นี้มีอยู่ — คำค้นแบบเดียวกันจากผู้ให้บริการเชิงพาณิชย์มักมาพร้อมเงื่อนไขการเผยแพร่ต่อ