Tra cứu mã số thuế — chi tiết & chi nhánh

Phiên bản nâng cao của tra cứu MST: trả về danh sách người nộp thuế khớp mã số thuế — gồm trụ sở chính và các chi nhánh/đơn vị trực thuộc, kèm cơ quan thuế quản lý và trạng thái từng đơn vị. Dữ liệu realtime từ Tổng cục Thuế.

GET /tax-code-2?tax={mst}

Tính phí

Mỗi lần gọi = 1 request tính phí (bậc thang, cao hơn tra cứu cơ bản vì trả chi tiết & chi nhánh). Xem Tính giá theo request.

Query Parameters

Name	Type	Bắt buộc	Mô tả
tax	string	✅	Mã số thuế cần tra cứu (10 hoặc 13 số). Chỉ nhận MST chính (không có dấu -).
attempts	number		Số lần thử tối đa (mặc định 5, trần 10). Tùy chọn.

Response

Trường	Kiểu	Mô tả
mst	string	Mã số thuế đã tra cứu
found	boolean	true nếu tìm thấy người nộp thuế
records	array	Danh sách đơn vị khớp (trụ sở chính + chi nhánh)
attempts	number	Số lần thử đã dùng để lấy kết quả

Mỗi phần tử trong records:

Trường	Kiểu	Mô tả
stt	string	Số thứ tự
mst	string	MST đơn vị (chi nhánh có dạng 0316520735-001)
name	string	Tên người nộp thuế
address	string	Địa chỉ trụ sở/kinh doanh
taxOffice	string	Cơ quan thuế quản lý
status	string	Trạng thái MST (vd NNT đang hoạt động)

cURL

curl "$BASE/tax-code-2?tax=0316520735" \
  -H "Authorization: Bearer $TOKEN" -H "Partner-Code: $PC"

Ví dụ response

{
  "mst": "0316520735",
  "found": true,
  "records": [
    {
      "stt": "1",
      "mst": "0316520735",
      "name": "CÔNG TY TNHH TƯ VẤN - ĐẠI LÝ THUẾ TFA",
      "address": "1329/1G Đường APĐ 09, Phường An Phú Đông, TP Hồ Chí Minh",
      "taxOffice": "Thuế cơ sở 12 Thành phố Hồ Chí Minh",
      "status": "NNT đang hoạt động"
    },
    {
      "stt": "2",
      "mst": "0316520735-001",
      "name": "CHI NHÁNH CÔNG TY TNHH TƯ VẤN - ĐẠI LÝ THUẾ TFA",
      "address": "125/6 Đường APĐ 09, Phường An Phú Đông, TP Hồ Chí Minh",
      "taxOffice": "Thuế cơ sở 12 Thành phố Hồ Chí Minh",
      "status": "NNT đang hoạt động"
    }
  ],
  "attempts": 1
}

Không tìm thấy

Nếu MST hợp lệ nhưng không có dữ liệu, API trả found: false và records: [] (vẫn tính phí 1 request).

So với tra cứu cơ bản

GET /tax-code (cơ bản) chỉ trả 1 pháp nhân với các trường phẳng (ten_cty, dia_chi…). GET /tax-code-2 trả nhiều đơn vị (kèm chi nhánh) và trạng thái từng đơn vị — phù hợp rà soát tập đoàn/chuỗi chi nhánh. Chỉ nhận tax qua query, vẫn cần Bearer + Partner-Code.