API Tra cứu thông tin Người nộp thuế (đầy đủ)

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ể

Request

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-records/:taxCode' \
-H 'Accept: application/json' \
-H 'client-id: <client-id>' \
-H 'api-key: <api-key>'

Response

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

{
  "success": true,
  "data": [
    {
      "orgType": "Hộ kinh doanh cá thể",
      "taxID": "036186003184",
      "name": "HỘ KINH DOANH HOTEL 19",
      "address": "Thửa đất số 187, tờ bản đồ số 19, Quốc lộ 10, Phường Nam Định, Ninh Bình",
      "taxDepartment": "Thuế cơ sở 5 tỉnh Ninh Bình",
      "status": "NNT đang hoạt động",
      "updatedAt": "2026-03-17T01:26:26.000Z"
    },
    {
      "orgType": "Hộ kinh doanh cá thể",
      "taxID": "036186003184",
      "name": "Hộ kinh doanh Hotel 19 - cơ sở Hà Nội",
      "address": "Số 29, ngõ 155 Nguyễn Khang, Phường Yên Hòa, TP Hà Nội",
      "taxDepartment": "Thuế cơ sở 5 thành phố Hà Nội",
      "status": "NNT đang hoạt động",
      "updatedAt": "2026-03-17T01:26:26.000Z"
    },
    {
      "orgType": "Hộ kinh doanh cá thể",
      "taxID": "036186003184",
      "name": "Nguyễn Thị Mai Hương",
      "address": "29T7 trsđ 361 tổ 21, Phường Yên Hòa, TP Hà Nội",
      "taxDepartment": "Thuế cơ sở 5 thành phố Hà Nội",
      "status": "NNT ngừng hoạt động và đã hoàn thành thủ tục chấm dứt hiệu lực MST",
      "updatedAt": "2026-03-17T01:26:26.000Z"
    },
    {
      "orgType": "Chi nhánh",
      "taxID": "8623505476-001",
      "name": "Nguyễn Thị Mai Hương",
      "address": "29T7 tập thể sư đoàn 361 tổ 44A đường Nguyễn Khang, Phường Yên Hoà(Hết hiệu lực), TP Hà Nội",
      "taxDepartment": "Thuế cơ sở 5 thành phố Hà Nội",
      "status": "NNT ngừng hoạt động và đã hoàn thành thủ tục chấm dứt hiệu lực MST",
      "updatedAt": "2026-03-17T01:26:26.000Z"
    }
  ]
}