cURL demo
cURL
curl -L 'https://api.xinvoice.vn/gdt-api/tax-payer/0101248141' \
-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
{
"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"
}