Vietnam Chart of Accounts API

Look up Vietnamese accounting accounts under Circular 99/2025 (from 2026) or 133/2016, search by name, browse levels and map TT 200 accounts to TT 99.

Parameters

Example

curl "https://apibox.io.vn/v1/vn-accounts/3331" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "number": "3331",
  "name_vi": "Thuế giá trị gia tăng phải nộp",
  "name_en": "VAT payable",
  "level": 2,
  "parent": "333",
  "group": 3,
  "group_name_vi": "Loại tài khoản nợ phải trả",
  "group_name_en": "Liabilities",
  "hierarchy": [
    {
      "number": "333",
      "name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "name_en": "Taxes and other payables to the State",
      "level": 1,
      "parent": null,
      "group": 3
    }
  ],
  "children": [
    {
      "number": "33311",
      "name_vi": "Thuế GTGT đầu ra",
      "name_en": "Output VAT",
      "level": 3,
      "parent": "3331",
      "group": 3
    },
    {
      "number": "33312",
      "name_vi": "Thuế GTGT hàng nhập khẩu",
      "name_en": "VAT on imports",
      "level": 3,
      "parent": "3331",
      "group": 3
    }
  ],
  "tt200_mapping": [
    {
      "tt200": "333",
      "tt200_name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "tt99": "333",
      "tt99_name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "change": "unchanged",
      "note_vi": "Giữ nguyên số hiệu, tên và TK cấp 2.",
      "note_en": "Number, name and level-2 accounts unchanged."
    }
  ],
  "chart": "tt99",
  "circular": "99/2025/TT-BTC",
  "title_vi": "Thông tư hướng dẫn Chế độ kế toán doanh nghiệp",
  "issued": "2025-10-27",
  "effective_from": "2026-01-01",
  "appendix": "Phụ lục II",
  "replaces": [
    "200/2014/TT-BTC",
    "75/2015/TT-BTC",
    "53/2016/TT-BTC",
    "195/2012/TT-BTC"
  ],
  "transition_vi": "Điều 29 (Chuyển đổi số dư trên sổ kế toán) và Điều 30 (Điều khoản chuyển tiếp).",
  "account_count": 184,
  "reviewed": "2026-11-11",
  "translation_note": "name_en is an unofficial translation"
}

Use cases

• Migrate an accounting or ERP system from TT 200 to TT 99
• Validate account numbers in imported journal entries
• Show account names in invoices or bookkeeping apps
• Build a chart-of-accounts picker with search

FAQ

Related APIs