Doanh nghiệp & Thuế entity-id/xref/{lei}

Toàn bộ mã định danh của một pháp nhân

Tra theo mã định danh pháp nhân toàn cầu (ISO 17442, 20 ký tự). Trả về ba khối: `entity` (tên pháp lý, quốc gia, thẩm quyền tài phán, hình thức pháp lý, tình trạng), `identifiers` (mã ngân hàng ISO 9362, mã sàn ISO 10383, mã tại sổ đăng ký của nước sở tại — tức cầu nối sang mã số thuế và số đăng ký kinh doanh trong nước — cùng vài mã đối chiếu khác), và `securities` (danh sách mã chứng khoán ISO 6166, có phân trang). Mã được kiểm số kiểm tra ISO 7064 tại chỗ nên gõ sai bị chặn ngay. Khối `securities` là lượt truy vấn thứ hai và có thể tắt bằng `securities=0`; nếu riêng nó lỗi thì phần còn lại vẫn trả về, kèm `securities.included = false`.

GET https://api-tools.hitechcloud.vn/api/entity-id/xref/{lei} Đã chép

Cần khoá API

Tham số

lei string · đường dẫn bắt buộc

Giá trị truyền trên đường dẫn.

securities string · truy vấn

Đặt 0 để bỏ khối mã chứng khoán và tiết kiệm một lượt truy vấn.

page string · truy vấn

Trang của danh sách mã chứng khoán. Mặc định 1.

per_page string · truy vấn

Số mã chứng khoán mỗi trang, mặc định 50, tối đa 200.

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/entity-id/xref/gia-tri?securities=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/entity-id/xref/gia-tri', [ 'securities' => 'GIA_TRI', 'page' => 'GIA_TRI', 'per_page' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/entity-id/xref/gia-tri", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "securities": "GIA_TRI", "page": "GIA_TRI", "per_page": "GIA_TRI", }, ) data = res.json()