Tra cứu mã số thuế

Truy xuất thông tin chi tiết của doanh nghiệp theo mã số thuế (MST).

GET /tax-code?tax={mst}

Tính phí

Mỗi lần gọi = 1 request tính phí (bậc thang). 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

Response

Trường	Kiểu	Mô tả
ma_so_thue	string	Mã số thuế của doanh nghiệp
masothue_id	string	ID mã số thuế
ten_cty	string	Tên đầy đủ công ty/doanh nghiệp
dia_chi	string	Địa chỉ đăng ký kinh doanh
cqthuecap_tinh	string | null	Cơ quan thuế cấp tỉnh quản lý
cqthue_ql	string	Cơ quan thuế quản lý trực tiếp
nguoi_dai_dien	string	Người đại diện pháp luật
ngay_thanh_lap	date (YYYY-MM-DD)	Ngày thành lập
tthai	string | null	Mã trạng thái hoạt động
ten_tthai	string | null	Tên trạng thái hoạt động

cURL

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

Ví dụ response

{
  "success": true,
  "ma_so_thue": "0319074775",
  "masothue_id": "0319074775",
  "ten_cty": "CÔNG TY CỔ PHẦN GIẢI PHÁP T CONNECT",
  "dia_chi": "232 Nguyễn Lương Bằng, Phường Tân Mỹ, Thành phố Hồ Chí Minh, Việt Nam",
  "cqthuecap_tinh": "Chi cục thuế Hồ Chí Minh",
  "cqthue_ql": "Thuế cơ sở 7 Thành phố Hồ Chí Minh",
  "nguoi_dai_dien": null,
  "ngay_thanh_lap": null,
  "tthai": null,
  "ten_tthai": null
}

Không cần mã hóa

API chỉ nhận tax qua query parameter, không cần AES. Vẫn cần header xác thực Bearer + Partner-Code.