State-budget codes (chương, tiểu mục) API

Look up chapter (chương) and sub-item (tiểu mục) codes for Vietnamese tax payment slips under TT 130/2025, with late-interest and abolished codes.

GEThttps://apibox.io.vn/v1/vn-budget-codes

Data & JSON▶ Try it online

Paying tax in Vietnam needs two codes from the state-budget index (mục lục ngân sách nhà nước): the chapter (chương) of the payer, e.g. 554 / 854 for private companies or 557 / 857 for households and individuals, and the sub-item (tiểu mục) of the revenue, e.g. 1001 PIT on salaries, 1052 CIT, 1701 domestic VAT, 2801 registration fee. This endpoint holds the 35 chapters taxpayers use and 215 tax, fee, fine and late-interest sub-items of Thông tư 130/2025/TT-BTC (from 1/1/2026), as amended by Thông tư 123/2026/TT-BTC (21/8/2026, e.g. new crypto-asset codes 1016 / 1059).

Look up one code (a pre-2025 district chapter such as 757 points to its new 857), search with q in Vietnamese with or without accents (“thue tncn”, “trước bạ”) or English, or filter by tax (pit, cit, vat, excise, import, env, resource, land, registration, licence, late_interest, fine, fee). Each tax sub-item links to the sub-item for its late-payment interest (Mục 4900).

The licence fee (lệ phí môn bài, 2862–2864) is marked abolished from 1/1/2026; the codes remain only to pay older debts. English names are our translation.

Parameters

Name	In	Type	Required	Default
`code`	query	string	no		A chapter (3 digits) or mục / tiểu mục (4 digits); also `/v1/vn-budget-codes/1001`.
`q`	query	string	no		Search text (Vietnamese with or without accents, or English).
`tax`	query	string	no		pit, cit, vat, excise, import, export, env, resource, land, registration, licence, late_interest, fine, fee, other.
`type`	query	string	no	`all`	`all`, `chapter` or `sub_item`.
`active_only`	query	boolean	no		Hide abolished items.
`limit`	query	number	no	`50`	Max results (1–500).

Example

curl "https://apibox.io.vn/v1/vn-budget-codes?code=1001" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-budget-codes?code=1001', {
  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/vn-budget-codes?code=1001",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-budget-codes?code=1001');
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

{
  "code": "1001",
  "kind": "sub_item",
  "muc": "1000",
  "muc_name_vi": "Thuế thu nhập cá nhân",
  "tax": "pit",
  "status": "active",
  "name_vi": "Thuế thu nhập từ tiền lương, tiền công",
  "name_en": "Tax on income from salaries and wages",
  "late_interest_code": "4917",
  "late_interest": {
    "code": "4917",
    "kind": "sub_item",
    "muc": "4900",
    "muc_name_vi": "Các khoản thu khác",
    "tax": "late_interest",
    "status": "active",
    "name_vi": "Tiền chậm nộp thuế thu nhập cá nhân (không bao gồm tiền chậm nộp thuế thu nhập cá nhân từ hoạt động giao dịch, chuyển nhượng, kinh doanh tài sản mã hoá)",
    "name_en": "Late-payment interest on PIT (excl. crypto-asset PIT)"
  },
  "legal": [
    "Thông tư 130/2025/TT-BTC (hiệu lực 01/01/2026)",
    "Thông tư 123/2026/TT-BTC (sửa đổi, hiệu lực 21/8/2026)"
  ],
  "reviewed": "2026-11-11"
}

Use cases

Fill the codes on state-budget payment slips in banking apps
Map tax types to tiểu mục in accounting software
Find the late-interest code that matches a tax
Convert old district chapters to the 2025 commune codes

FAQ

Did TT 130/2025 change the tax codes?

No tax, fee or late-interest code was renumbered from TT 324/2016; some names changed. Chapters of the abolished districts moved from 754–760 to 854–860 on 1/7/2025.

Which chapter do individuals use for PIT?

557 when the provincial tax office manages it, 857 when a grassroots office does (note of Mục 1000 in TT 130/2025).

Is lệ phí môn bài still paid?

No. It was abolished from 1/1/2026 (Nghị quyết 198/2025/QH15); the codes are kept to collect earlier years.

Related APIs

{✓}

State-budget codes (chương, tiểu mục) API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON