API tra cứu mã số thuế doanh nghiệp

Q: Tìm doanh nghiệp theo tên được không?

Không. Bộ businesses tra theo mã số thuế (tax_code), hoặc lọc theo ngày cấp (cert_from, cert_to) và ngày cập nhật (updated_from). Nếu người dùng của bạn chỉ có tên công ty, hãy để họ nhập mã số thuế in trên hoá đơn hoặc hợp đồng.

Q: Mã số thuế đơn vị phụ thuộc (13 số) có tra được không?

Có. Truyền dạng 0101234567-001; mã 10 số là của doanh nghiệp, phần -001 trở đi là chi nhánh, đơn vị phụ thuộc.

Q: Muốn lấy danh sách doanh nghiệp mới thành lập thì gọi thế nào?

Lọc theo ngày cấp: GET /v1/businesses?cert_from=2026-09-01&cert_to=2026-09-30. Kết quả xếp theo ngày cấp mới nhất trước, phân trang bằng page.

Q: Gói miễn phí có tra được mã số thuế không?

Không — bộ businesses mở từ gói Starter. Danh mục tỉnh, phường/xã (mst-provinces, mst-wards) thì gói Free dùng được.

Người dùng gõ mã số thuế của khách hàng, phần mềm tự điền tên công ty và địa chỉ lên hoá đơn; trước khi ký hợp đồng, hệ thống tự kiểm tra đối tác còn hoạt động hay đã ngừng. API tra cứu mã số thuế làm đúng việc đó: nhận mã số thuế, trả thông tin doanh nghiệp dưới dạng JSON.

Đăng ký lấy key miễn phí Xem tài liệu API

Ba endpoint

Endpoint	Dữ liệu	Tài liệu
`GET /v1/businesses`	Thông tin doanh nghiệp theo mã số thuế.	Xem
`GET /v1/mst-provinces`	Danh mục tỉnh, thành phố dùng trong hồ sơ thuế.	Xem
`GET /v1/mst-wards`	Danh mục phường, xã theo tỉnh.	Xem

Ví dụ: tra một mã số thuế

Lệnh gọi (thay dlpl_live_xxx bằng key của bạn)

curl -s "https://api.dulieuphapluat.vn/v1/businesses?tax_code=0100109106" \
  -H "Authorization: Bearer dlpl_live_xxx"

Dạng kết quả trả về

{
    "success": true,
    "data": [
        {
            "tax_code": "…",
            "name": "…",
            "name_short": "…",
            "address": "…",
            "status_id": "…",
            "cert_date": "…"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "has_more": true
    }
}

Danh mục phường, xã của một tỉnh

Lệnh gọi (thay dlpl_live_xxx bằng key của bạn)

curl -s "https://api.dulieuphapluat.vn/v1/mst-wards?province_code=01&per_page=2" \
  -H "Authorization: Bearer dlpl_live_xxx"

Dạng kết quả trả về

{
    "success": true,
    "data": [
        {
            "code": "…",
            "name": "…",
            "full_name": "…",
            "province_code": "…",
            "province_name": "…",
            "unit_type": "…"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "has_more": true
    }
}

Tham số chính

Tham số	Dùng ở	Ý nghĩa
`tax_code`	Doanh nghiệp	Mã số thuế 10 số, hoặc 13 số dạng `0101234567-001`.
`cert_from`, `cert_to`	Doanh nghiệp	Khoảng ngày cấp mã số thuế, dạng `YYYY-MM-DD`.
`updated_from`	Doanh nghiệp	Chỉ lấy bản ghi cập nhật từ ngày này — dùng để đồng bộ phần thay đổi.
`status_id`	Doanh nghiệp	Lọc theo trạng thái hoạt động.
`q`	Tỉnh, phường/xã	Tìm theo tên.
`province_code`	Phường/xã	Mã tỉnh 2 số, lấy từ `/v1/mst-provinces`.

Bộ doanh nghiệp cần ít nhất một trong tax_code, cert_from, updated_from.

Các trường trả về

Trường	Ý nghĩa	Gói
`tax_code`	Mã số thuế.	Starter
`name`, `name_short`	Tên doanh nghiệp, tên viết tắt.	Starter
`address`	Địa chỉ trụ sở.	Starter
`status_id`	Mã trạng thái hoạt động (tra bảng `business-statuses`).	Starter
`cert_date`, `updated_at`	Ngày cấp mã số thuế, thời điểm cập nhật bản ghi gần nhất.	Starter
`trade_name`, `activity_date`	Tên giao dịch, ngày bắt đầu hoạt động.	Pro
`tax_type`, `tax_admin_code`, `tax_payment_code`	Loại hình nộp thuế, cơ quan thuế quản lý, nơi nộp thuế.	Pro
`financial_year_end`	Ngày kết thúc năm tài chính.	Pro

Dữ liệu lấy từ đâu

Cùng nguồn với công cụ tra cứu mã số thuế trên dulieuphapluat.vn. Mỗi bản ghi có trường updated_at cho biết lần cập nhật gần nhất, nên phần mềm của bạn biết thông tin đang dùng mới tới đâu.

Gói nào dùng được

Endpoint	Gói thấp nhất
`/v1/businesses`	Starter (trường mở rộng từ Pro)
`/v1/mst-provinces`, `/v1/mst-wards`	Free

Gói	Giá / tháng	Lượt gọi / tháng	Lượt gọi / ngày	Bản ghi / trang
Free	0đ	1.000	100	10
Starter	199.000đ	20.000	2.000	20
Pro	699.000đ	120.000	8.000	50
Business	2.490.000đ	600.000	30.000	100

Giá chưa gồm VAT, theo bảng giá ngày 01/10/2026. Bảng giá đang áp dụng: xem trên trang API.

Câu hỏi thường gặp khi tích hợp

Tìm doanh nghiệp theo tên được không?

Không. Bộ businesses tra theo mã số thuế (tax_code), hoặc lọc theo ngày cấp (cert_from, cert_to) và ngày cập nhật (updated_from). Nếu người dùng của bạn chỉ có tên công ty, hãy để họ nhập mã số thuế in trên hoá đơn hoặc hợp đồng.

Mã số thuế đơn vị phụ thuộc (13 số) có tra được không?

Có. Truyền dạng 0101234567-001; mã 10 số là của doanh nghiệp, phần -001 trở đi là chi nhánh, đơn vị phụ thuộc.

status_id nghĩa là gì?

Là mã trạng thái hoạt động của mã số thuế (đang hoạt động, tạm ngừng, đã chấm dứt…). Bảng mã nằm ở bộ dữ liệu business-statuses, gọi một lần rồi lưu lại để hiển thị tên trạng thái.

Muốn lấy danh sách doanh nghiệp mới thành lập thì gọi thế nào?

Lọc theo ngày cấp: GET /v1/businesses?cert_from=2026-09-01&cert_to=2026-09-30. Kết quả xếp theo ngày cấp mới nhất trước, phân trang bằng page.

Gói miễn phí có tra được mã số thuế không?

Không — bộ businesses mở từ gói Starter. Danh mục tỉnh, phường/xã (mst-provinces, mst-wards) thì gói Free dùng được.

Bắt đầu với gói miễn phí

Đăng ký bằng email, lấy key và gọi thử ngay — không cần thanh toán.

Đăng ký lấy key miễn phí Xem tài liệu API