Vietnam university major codes API

Look up Vietnamese higher-education major codes (mã ngành) by code or name: TT 09/2022 bachelor, master, doctorate codes and their new TT 74/2026 codes.

GEThttps://apibox.io.vn/v1/vn-majors

Data & JSON▶ Try it online

Searches the national catalogue of higher-education majors: Thông tư 09/2022/TT-BGDĐT (7-digit codes: 7 = bachelor, 8 = master, 9 = doctorate, with 3-digit fields and 5-digit groups), used for admissions until 31/12/2026, and Thông tư 74/2026/TT-BGDĐT (one 6-digit code for all levels, 2-digit fields, 4-digit groups), in force from 12/10/2026 for admissions from 1/1/2027.

Look up a code (old or new) to get its name, field and group and the matching code in the other catalogue: the old → new mapping follows Phụ lục II of TT 74/2026 (for example the seven foreign-language teacher majors merge into 140238 Sư phạm tiếng nước ngoài), the unchanged codes keep their last six digits. Or search by name, accents optional, filtered by catalogue, level, kind or field.

TT 09/2022 is parsed from the Official Gazette PDF; TT 74/2026 was published only as a scan and was transcribed and reviewed by hand, so report any difference with the official text.

Parameters

Name	In	Type	Required	Default
`code`	query\|path	string	no		Old (TT 09) or new (TT 74) code, 2–7 digits (also /v1/vn-majors/{code}).
`q`	query	string	no		Name search, accents optional.
`catalogue`	query	string	no	`all`	`tt09`, `tt74` or `all`.
`level`	query	string	no		TT 09 level: 7 (bachelor), 8 (master), 9 (doctorate).
`kind`	query	string	no	`major`	`major`, `group`, `field` or `all`.
`limit`	query	number	no	`30`	Max results (1–200).

Example

curl "https://apibox.io.vn/v1/vn-majors?code=7480201" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "query": "7480201",
  "tt09": {
    "code": "7480201",
    "name": "Công nghệ thông tin",
    "catalogue": "TT 09/2022",
    "kind": "major",
    "level": "Đại học",
    "level_en": "Bachelor",
    "field": {
      "code": "748",
      "name": "Máy tính và công nghệ thông tin"
    },
    "group": {
      "code": "74802",
      "name": "Công nghệ thông tin"
    },
    "new_codes": [
      {
        "code": "480201",
        "name": "Công nghệ thông tin",
        "catalogue": "TT 74/2026",
        "kind": "major",
        "field": {
          "code": "48",
          "name": "Máy tính và công nghệ thông tin"
        },
        "group": {
          "code": "4802",
          "name": "Công nghệ thông tin"
        }
      }
    ]
  },
  "sources": {
    "tt09": "Thông tư 09/2022/TT-BGDĐT, Phụ lục I (https://static.dav.edu.vn/files/2024/06/14/tt09-06-06-2022-danh-muc-nganh-dao-tao.pdf)",
    "tt74": "Thông tư 74/2026/TT-BGDĐT, Phụ lục I–II (https://datafiles.chinhphu.vn/cpp/files/vbpq/2026/9/74-bgddt.signed.pdf), transcribed 2026-11-11"
  },
  "data_version": "f73cfa51a5e8",
  "note": "TT 09/2022 codes apply to admissions until 31/12/2026; TT 74/2026 (in force from 12/10/2026) applies from 1/1/2027. Old codes stay in the catalogue as history."
}

Use cases

Admission portals and university websites listing majors
Normalise the field of study in CVs and HR systems
Migrate program data from the old to the new codes for 2027
Career-guidance apps searching majors by name

FAQ

Which catalogue applies to admissions in 2027?

TT 74/2026. Its codes have 6 digits shared by bachelor, master and doctorate programs; TT 09/2022 codes stay as history.

Is every old code mapped?

Almost: about a dozen master / doctorate codes have no listed successor and return no new_codes.

Are vocational (college) codes included?

No, only higher education (đại học, thạc sĩ, tiến sĩ).

Related APIs

{✓}

Vietnam university major codes API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON