API tra cứu mã số thuế

Tra cứu thông tin doanh nghiệp theo mã số thuế (MST): tên công ty, địa chỉ, cơ quan thuế quản lý, người đại diện, ngày thành lập, trạng thái hoạt động.

Dành cho AI/Agent

👉 Tải đặc tả API đầy đủ (single-file cho Vibe code / AI Agent)

Tất cả đường dẫn dưới đây là tương đối so với base URL.

STT	Chức năng	Method	Endpoint	Tính phí
1	Tra cứu mã số thuế	GET	/tax-code?tax={mst}	✅ theo request
2	Tra cứu MST — chi tiết & chi nhánh	GET	/tax-code-2?tax={mst}	✅ theo request

Đặc điểm

• Không cần mã hóa — chỉ truyền tax qua query parameter (khác với các API cần AES).
• Có đo đếm để tính tiền — mỗi lần gọi được đếm request (dùng chung bộ đếm với API tra cứu hóa đơn đầu vào); quy ra tiền theo bậc thang. Xem Tính giá theo request.

Xác thực

Dùng chung cơ chế Open API: Authorization: Bearer <access_token> + Partner-Code (xem Giới thiệu). API này không mã hóa body/tham số.

Bảng giá (tóm tắt)

Bậc thang lũy tiến lùi — càng nhiều request đơn giá càng giảm. Hai endpoint tính bậc thang độc lập.

Bậc (đến request thứ)	GET /tax-code (cơ bản)	GET /tax-code-2 (chi tiết & chi nhánh)
100	4.000đ	8.000đ
500	2.000đ	4.000đ
1.000	1.000đ	2.000đ
> 1.000 (vượt)	500đ	1.000đ

tax-code vừa giảm 50%; tax-code-2 (trả trụ sở chính + chi nhánh, trạng thái từng đơn vị) bằng mức giá tax-code trước đây. Công cụ tính: Tính giá theo request.