API Tra cứu thông tin Người nộp thuế

Tra cứu thông tin người nộp thuế dùng cho mục đích xuất hoá đơn. Có thể tra cứu doanh nghiệp, tổ chức hoặc hộ kinh doanh cá thể

GET https://api.xinvoice.vn/gdt-api/tax-payer/:taxCode

Request

Request Description 
taxCode: Mã số thuế của người nộp thuế cần tra cứu. Ví dụ: 0101248141
Headers:
- client-id: ID của khách hàng được cấp khi đăng ký sử dụng API
- api-key: Khóa API tương ứng với client-id
curl -L 'https://api.xinvoice.vn/gdt-api/tax-payer/:taxCode' \
-H 'Accept: application/json' \
-H 'client-id: <client-id>' \
-H 'api-key: <api-key>'

Response

Response Description 
orgType: Loại tổ chức. 
Doanh nghiệp / Đơn vị sự nghiệp công lập
Chi nhánh
Hộ kinh doanh cá thể

taxID: Mã số thuế.
Ví dụ: 0316794479; 0316794479-001; 077064000457

name: Tên của người nộp thuế.
Ví dụ: CÔNG TY CỔ PHẦN FPT

address: Địa chỉ của người nộp thuế.
Ví dụ: Số 10 phố Phạm Văn Bạch, Phường Cầu Giấy, TP Hà Nội

taxDepartment: Chi cục thuế của người nộp thuế.
Ví dụ: Chi cục Thuế Doanh nghiệp lớn

status: Trạng thái hoạt động của người nộp thuế.
Đợi phản hồi ĐKDN
Mã số thuế chờ cập nhật thông tin số định danh cá nhân
NNT chờ xác minh tình trạng hoạt động tại địa chỉ đã đăng ký
NNT đã chuyển cơ quan thuế quản lý
NNT đang hoạt động
NNT đang hoạt động (chưa đầy đủ thủ tục cấp MST)
NNT đang hoạt động (đã được cấp GCN ĐKT)
NNT không hoạt động tại địa chỉ đã đăng ký
NNT ngừng HĐ nhưng chưa hoàn thành thủ tục chấm dứt hiệu lực MST
NNT ngừng hoạt động và đã đóng MST
NNT ngừng hoạt động và đã hoàn thành thủ tục chấm dứt hiệu lực MST
NNT tạm ngừng KD có thời hạn

updatedAt: Thời gian cập nhật thông tin của người nộp thuế.
Ví dụ: 2025-12-19T08:35:45.000Z

{
  "orgType": "Doanh nghiệp / Đơn vị sự nghiệp công lập",
  "taxID": "0101248141",
  "name": "CÔNG TY CỔ PHẦN FPT",
  "address": "Số 10 phố Phạm Văn Bạch, Phường Cầu Giấy, TP Hà Nội",
  "taxDepartment": "Chi cục Thuế Doanh nghiệp lớn",
  "status": "NNT đang hoạt động",
  "updatedAt": "2025-12-19T08:35:45.000Z"
}