Doanh nghiệp & Thuế lei/search

Tìm pháp nhân trong sổ đăng ký LEI toàn cầu theo tên

Quốc gia, tình trạng hoặc mã BIC. Trả về danh sách bản ghi đã rút gọn kèm phân trang. Mỗi kết quả có `registered_as` — mã doanh nghiệp tại sổ đăng ký của nước sở tại, tức cầu nối giữa LEI và mã số thuế hoặc số đăng ký kinh doanh trong nước. Cần ít nhất một điều kiện lọc.

GET https://api-tools.hitechcloud.vn/api/lei/search Đã chép

Cần khoá API

Tham số

q string · truy vấn

Tìm toàn văn: quét tên pháp lý, tên cũ và địa chỉ. Dùng khi chỉ biết tên gần đúng.

name string · truy vấn

Khớp theo tên pháp lý, hẹp hơn q. Dùng khi biết chính xác tên đăng ký.

country string · truy vấn

Mã quốc gia ISO 3166-1 alpha-2 của địa chỉ đăng ký, ví dụ VN, GB, SG.

bic string · truy vấn

Mã BIC/SWIFT của tổ chức tài chính, ví dụ APLEUS66XXX. Tra ngược ra pháp nhân.

status enum · truy vấn

Tình trạng pháp nhân: ACTIVE hoặc INACTIVE.

registration_status enum · truy vấn

Tình trạng bản ghi LEI: ISSUED, LAPSED, RETIRED, ANNULLED, MERGED. LAPSED nghĩa là chủ thể chưa gia hạn — dữ liệu có thể đã cũ.

page integer · truy vấn

Số trang, đếm từ 1. Mặc định 1.

per_page integer · truy vấn

Số bản ghi mỗi trang, 1–100. Mặc định 15.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

curl --location 'https://api-tools.hitechcloud.vn/api/lei/search?q=GIA_TRI&name=GIA_TRI&country=GIA_TRI&bic=GIA_TRI&status=GIA_TRI&registration_status=GIA_TRI&page=GIA_TRI&per_page=GIA_TRI' \ --header 'X-API-Key: $HITECH_API_KEY' \ --header 'Accept: application/json'

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/lei/search', [ 'q' => 'GIA_TRI', 'name' => 'GIA_TRI', 'country' => 'GIA_TRI', 'bic' => 'GIA_TRI', 'status' => 'GIA_TRI', 'registration_status' => 'GIA_TRI', 'page' => 'GIA_TRI', 'per_page' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/lei/search", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "q": "GIA_TRI", "name": "GIA_TRI", "country": "GIA_TRI", "bic": "GIA_TRI", "status": "GIA_TRI", "registration_status": "GIA_TRI", "page": "GIA_TRI", "per_page": "GIA_TRI", }, ) data = res.json()