Xinvoice

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ể. Trả về toàn bộ bản ghi liên quan tới mã số thuế.

GEThttps://api.xinvoice.vn/gdt-api/tax-payer-records/:taxCode

cURL demo

cURL
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>'

Request

Request Description

taxCode

Mã số thuế của người nộp thuế cần tra cứu.

Ví dụ: 0101248141

client-id

Header. ID của khách hàng được cấp khi đăng ký sử dụng API.

api-key

Header. Khóa API tương ứng với client-id.

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

JSON
{
  "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"
    }
  ]
}