Vietnam Industry Codes (VSIC) API

Search and browse Vietnam’s economic activity codes (VSIC 2025, Decision 36/2025/QĐ-TTg) used for business registration, with VSIC 2018 and the official 2018 ↔ 2025 conversion.

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

Data & JSON▶ Try it online

The VSIC API gives the Vietnamese Standard Industrial Classification, the “mã ngành kinh tế” declared when registering a company. Since 15 November 2025 the system is VSIC 2025 (Decision 36/2025/QĐ-TTg): 22 sections, 87 divisions, 259 groups, 495 classes and 743 sub-classes. code=4711 returns a code with its level, its path up to the section, its children and the matching VSIC 2018 codes; q= searches names without accents (q=ban le giay dep), level-4 codes first because those are the ones used for business registration; parent= and level= browse the tree.

VSIC 2018 (Decision 27/2018/QĐ-TTg, with English names) is still available with version=2018, because existing business licences, contracts and databases use its codes. Every code carries its correspondence in the other version, from the official conversion table of the General Statistics Office (Công văn 3061/CTK-CSCL, 26/12/2025); partial: true marks codes that were split or merged, where you must pick the right one by activity.

The 2025 list is re-read every week from the national business-registration portal and checked against the official counts; changes to the conversion annexes are detected and reviewed.

Parameters

Name	In	Type	Required	Default
`code`	query\|path	string	no		A code (A, 47, 471, 4711, 47110).
`q`	query	string	no		Search names (accents optional).
`level`	query	number	no		List one level (1–5), or filter the search.
`parent`	query	string	no		Children of a code.
`version`	query	string	no	`2025`	`2025` or `2018`.
`limit`	query	number	no	`30`	Max search results (1–200).

Example

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));

Response

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

Use cases

Business line pickers in company registration and accounting software
Migrate stored VSIC 2018 codes to VSIC 2025
Classify customers and suppliers by industry
Statistics and reports by economic sector

FAQ

Which level is used for business registration?

Level 4 (4 digits). The enterprise registration decree (Nghị định 168/2025/NĐ-CP) refers to the current VSIC, i.e. VSIC 2025 since 15/11/2025.

My 2018 code does not exist any more: what now?

Call /v1/vsic?code=…&version=2018: in_vsic_2025 lists the new code(s). When it is partial, the old activity was split and you choose the one that fits.

Is there an English version of VSIC 2025?

No official one yet; English names are available for VSIC 2018 only.

Related APIs

{✓}

Vietnam Industry Codes (VSIC) API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON