API Documentation - Company Lookup

Tổng quan

API cho phép tra cứu thông tin công ty/doanh nghiệp Việt Nam dựa trên mã số thuế (MST). Dữ liệu được lấy từ nguồn công khai và trả về định dạng JSON.

GET https://companylookup.hqv.biz/?mst={tax_code}

Tham số

Tham số	Loại	Mô tả
mst BẮT BUỘC	string	Mã số thuế doanh nghiệp (10-14 ký tự số, có thể chứa dấu gạch ngang)

Các trường dữ liệu trả về

Khi tra cứu thành công, API trả về object data với các trường sau:

taxCodeMã số thuế

nameTên công ty

nameInternationalTên quốc tế

nameShortTên viết tắt

addressĐịa chỉ đầy đủ

addressLine1Số nhà, tên đường

cityPhường/Xã/Quận

stateProvinceTỉnh/Thành phố

countryQuốc gia

representativeNgười đại diện pháp luật

phoneSố điện thoại

establishedDateNgày hoạt động

statusTình trạng hoạt động

businessTypeLoại hình doanh nghiệp

businessSectorNgành nghề chính

managedByCơ quan thuế quản lý

Mã trạng thái HTTP

200Thành công - Trả về thông tin công ty

400Bad Request - Thiếu tham số hoặc định dạng MST không hợp lệ

404Not Found - Không tìm thấy công ty với MST đã cho

500Server Error - Lỗi hệ thống

Ví dụ Response

✓ Thành công (200)

{
    "success": true,
    "data": {
        "taxCode": "0315065353",
        "name": "CÔNG TY TNHH PHẦN MỀM HÀO QUANG VIỆT",
        "nameInternational": "HAO QUANG VIET SOFTWARE COMPANY LIMITED",
        "address": "Tầng 19, Indochina Park Tower, Phường Tân Định, TP HCM",
        "representative": "TRẦN VĂN QUYẾT",
        "phone": "02877796009",
        "status": "Đang hoạt động"
    }
}

✗ Không tìm thấy (404)

{
    "success": false,
    "error": "Company not found",
    "taxCode": "1234567890"
}

Ví dụ Code

cURL

curl "https://companylookup.hqv.biz/?mst=0315065353"

JavaScript

const res = await fetch('https://companylookup.hqv.biz/?mst=0315065353');
const data = await res.json();
if (data.success) console.log(data.data.name);

PHP

$json = file_get_contents('https://companylookup.hqv.biz/?mst=0315065353');
$data = json_decode($json, true);
if ($data['success']) echo $data['data']['name'];

Python

import requests
r = requests.get('https://companylookup.hqv.biz/', params={'mst': '0315065353'})
data = r.json()
if data['success']: print(data['data']['name'])

Company Lookup API