Mã ngành kinh tế VSIC API

Tra cứu hệ thống ngành kinh tế Việt Nam (VSIC 2025, Quyết định 36/2025/QĐ-TTg) dùng khi đăng ký kinh doanh, kèm VSIC 2018 và bảng chuyển đổi chính thức 2018 ↔ 2025.

GEThttps://apibox.io.vn/v1/vsic

Dữ liệu & JSON▶ Dùng thử online

API VSIC cung cấp Hệ thống ngành kinh tế Việt Nam, tức “mã ngành” khai khi đăng ký doanh nghiệp. Từ 15/11/2025 áp dụng VSIC 2025 (Quyết định 36/2025/QĐ-TTg): 22 ngành cấp 1, 87 cấp 2, 259 cấp 3, 495 cấp 4 và 743 cấp 5. code=4711 trả về mã kèm cấp, đường dẫn đến ngành cấp 1, các mã con và mã tương ứng trong VSIC 2018; q= tìm theo tên không cần dấu (q=ban le giay dep), ưu tiên mã cấp 4 vì đó là cấp dùng khi đăng ký kinh doanh; parent= và level= để duyệt cây.

VSIC 2018 (Quyết định 27/2018/QĐ-TTg, có tên tiếng Anh) vẫn tra được với version=2018, vì giấy phép kinh doanh, hợp đồng và cơ sở dữ liệu hiện có còn dùng mã cũ. Mỗi mã đều kèm mã tương ứng ở phiên bản kia theo bảng chuyển đổi chính thức của Cục Thống kê (Công văn 3061/CTK-CSCL ngày 26/12/2025); partial: true đánh dấu mã bị tách hoặc gộp, khi đó cần chọn mã đúng theo hoạt động thực tế.

Danh mục 2025 được đọc lại hằng tuần từ Cổng thông tin quốc gia về đăng ký doanh nghiệp và đối chiếu với số lượng chính thức; thay đổi của các phụ lục chuyển đổi được phát hiện và rà soát.

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định
`code`	query\|path	string	không		Một mã (A, 47, 471, 4711, 47110).
`q`	query	string	không		Tìm theo tên (không cần dấu).
`level`	query	number	không		Liệt kê một cấp (1–5), hoặc lọc kết quả tìm.
`parent`	query	string	không		Các mã con của một mã.
`version`	query	string	không	`2025`	`2025` hoặc `2018`.
`limit`	query	number	không	`30`	Số kết quả tìm tối đa (1–200).

Ví dụ

curl "https://apibox.io.vn/v1/vsic?q=ban le giay dep" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vsic?q=ban le giay dep', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vsic?q=ban le giay dep",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vsic?q=ban le giay dep');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "version": "2025",
  "decision": "36/2025/QĐ-TTg",
  "in_force": "2025-11-15",
  "updated": "2026-11-10",
  "query": "ban le giay dep",
  "count": 2,
  "results": [
    {
      "code": "4771",
      "name": "Bán lẻ hàng may mặc, giày, dép, hàng da và giả da",
      "level": 4,
      "path": "G > 47 > 477"
    },
    {
      "code": "47712",
      "name": "Bán lẻ giày, dép",
      "level": 5,
      "path": "G > 47 > 477 > 4771"
    }
  ]
}

Ứng dụng

Chọn ngành nghề trong phần mềm đăng ký doanh nghiệp, kế toán
Chuyển mã VSIC 2018 đang lưu sang VSIC 2025
Phân loại khách hàng, nhà cung cấp theo ngành
Thống kê, báo cáo theo ngành kinh tế

Hỏi đáp

Đăng ký kinh doanh dùng mã cấp mấy?

Cấp 4 (4 chữ số). Nghị định đăng ký doanh nghiệp (Nghị định 168/2025/NĐ-CP) dẫn chiếu Hệ thống ngành kinh tế hiện hành, tức VSIC 2025 từ 15/11/2025.

Mã 2018 của tôi không còn nữa thì sao?

Gọi /v1/vsic?code=…&version=2018: in_vsic_2025 liệt kê mã mới. Nếu partial là true, ngành cũ đã bị tách và bạn chọn mã phù hợp.

VSIC 2025 có bản tiếng Anh không?

Chưa có bản chính thức; tên tiếng Anh chỉ có cho VSIC 2018.

API liên quan

{✓}

Mã ngành kinh tế VSIC API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

Kiểm tra JSON

Định dạng JSON

CSV sang JSON