Doanh nghiệp & Thuế
tax/business/{taxCode}
Tra cứu doanh nghiệp theo mã số thuế
Trả về thông tin đăng ký thuế của một doanh nghiệp: tên pháp lý, địa chỉ trụ sở theo địa giới mới, ngày bắt đầu hoạt động và tình trạng hoạt động.
Kết quả được lưu đệm 24 giờ; thêm refresh=1 để buộc gọi lại nguồn gốc.
GET
https://api-tools.hitechcloud.vn/api/tax/business/{taxCode}
Đã chép
Cần khoá API
Đệm 24 giờ
60 lượt/phút
Nguồn: gdt.gov.vn
Tham số
taxCode
string
·
đường dẫn
bắt buộc
Mã số thuế 10 hoặc 13 chữ số. Dạng 13 số dùng cho chi nhánh, ví dụ 0316954486-001.
refresh
boolean
·
truy vấn
Bỏ qua bộ đệm và gọi thẳng nguồn. Chậm hơn 3–5 giây và tính thêm một lượt gọi.
fields
string
·
truy vấn
Danh sách trường cần lấy, ngăn bằng dấu phẩy. Bỏ trống để lấy đủ.
Mã trả về
200
Tìm thấy doanh nghiệp.
404
Mã số thuế đúng định dạng nhưng không có trong dữ liệu Tổng cục Thuế.
429
Vượt 60 lượt/phút. Xem header
Retry-After để biết chờ bao lâu.
503
Nguồn gdt.gov.vn không phản hồi. Thử lại sau, dữ liệu đệm vẫn dùng được.