Doanh nghiệp & Thuế entity-id/resolve

Tra ngược

Từ một mã bất kỳ ra pháp nhân sở hữu mã đó. Nhận đúng MỘT trong `isin` (mã chứng khoán ISO 6166), `bic` (mã ngân hàng ISO 9362, chấp nhận cả bản 8 lẫn 11 ký tự), `mic` (mã sàn giao dịch ISO 10383) hoặc `ocid` (mã tại kho đăng ký doanh nghiệp mở). Gửi nhiều mã cùng lúc bị từ chối thay vì tự chọn một cái, vì chọn giúp là đoán ý người gọi. Mỗi kết quả gồm danh tính pháp nhân và trọn bộ mã của họ. Một mã có thể ứng với nhiều pháp nhân nên `results` luôn là mảng.

GET https://api-tools.hitechcloud.vn/api/entity-id/resolve Đã chép

Cần khoá API

Tham số

isin string · truy vấn

Mã chứng khoán ISO 6166, 12 ký tự. Ví dụ US0378331005.

bic string · truy vấn

Mã ngân hàng ISO 9362, 8 hoặc 11 ký tự. Bản 8 ký tự tự động thêm XXX.

mic string · truy vấn

Mã sàn giao dịch ISO 10383, 4 ký tự. Ví dụ XNYS.

ocid string · truy vấn

Mã tại kho đăng ký doanh nghiệp mở, ví dụ us_de/4348344.

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/resolve?isin=GIA_TRI&bic=GIA_TRI&mic=GIA_TRI&ocid=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/resolve', [ 'isin' => 'GIA_TRI', 'bic' => 'GIA_TRI', 'mic' => 'GIA_TRI', 'ocid' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/entity-id/resolve", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "isin": "GIA_TRI", "bic": "GIA_TRI", "mic": "GIA_TRI", "ocid": "GIA_TRI", }, ) data = res.json()