Tra cứu thông tin mã số thuế

API dùng để truy xuất thông tin chi tiết của doanh nghiệp dựa trên mã số thuế (MST).

Base URL (Sandbox): https://sandbox-api.tconnect.vn/invoice

---

Endpoint

GET /tax-code

---

Query Parameters

Tên	Kiểu	Bắt buộc	Mô tả
tax	string	✅	Mã số thuế cần tra cứu

---

Response

200 — Thành công

{
  "nguoi_dai_dien": null,
  "ngay_thanh_lap": null,
  "tthai": null,
  "ten_tthai": null,
  "ma_so_thue": "0319074775",
  "masothue_id": "0319074775",
  "ten_cty": "CÔNG TY CỔ PHẦN GIẢI PHÁP T CONNECT",
  "success": true,
  "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"
}

Mô tả các trường

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

---

Ví dụ

curl --location 'https://sandbox-api.tconnect.vn/invoice/tax-code?tax=0319074775'

---

Lưu ý

• tax phải là MST hợp lệ.
• Một số trường có thể trả về null nếu chưa có dữ liệu.
• Format ngày: YYYY-MM-DD.