🇻🇳 VN Region API - API Tỉnh Thành Phường Xã Việt Nam

JavaScript (Fetch API)

// Lấy danh sách tỉnh/thành
fetch("https://huynhminhvangit.github.io/vn-region-api/data/provinces.json")
  .then(res => res.json())
  .then(data => console.log(data));

// Lấy tỉnh theo mã code (sử dụng API endpoint)
fetch("https://huynhminhvangit.github.io/vn-region-api/api/provinces.html?code=01")
  .then(res => res.text())
  .then(html => {
    const match = html.match(/
(.*?)<\/pre>/s);
    if (match) {
      const data = JSON.parse(match[1]);
      console.log(data);
    }
  });

// Tìm kiếm tỉnh theo tên (sử dụng API endpoint)  
fetch("https://huynhminhvangit.github.io/vn-region-api/api/provinces.html?name=" + encodeURIComponent("Hà Nội"))
  .then(res => res.text())
  .then(html => {
    const match = html.match(/
(.*?)<\/pre>/s);
    if (match) {
      const data = JSON.parse(match[1]);
      console.log(data);
    }
  });

// Lấy danh sách phường/xã theo mã tỉnh
fetch("https://huynhminhvangit.github.io/vn-region-api/api/wards.html?province_code=01")
  .then(res => res.text())
  .then(html => {
    const match = html.match(/
(.*?)<\/pre>/s);
    if (match) {
      const data = JSON.parse(match[1]);
      console.log(data);
    }
  });

// Lấy danh sách phường/xã theo tên tỉnh
fetch("https://huynhminhvangit.github.io/vn-region-api/api/wards.html?province_name=" + encodeURIComponent("Hà Nội"))
  .then(res => res.text())
  .then(html => {
    const match = html.match(/
(.*?)<\/pre>/s);
    if (match) {
      const data = JSON.parse(match[1]);
      console.log(data);
    }
  });
            

cURL Examples

# Lấy tất cả tỉnh/thành
curl -X GET "https://huynhminhvangit.github.io/vn-region-api/data/provinces.json"

# Lấy tỉnh theo mã code
curl -X GET "https://huynhminhvangit.github.io/vn-region-api/api/provinces.html?code=01"

# Tìm kiếm tỉnh theo tên
curl -X GET "https://huynhminhvangit.github.io/vn-region-api/api/provinces.html?name=Hà%20Nội"

# Lấy phường/xã theo mã tỉnh
curl -X GET "https://huynhminhvangit.github.io/vn-region-api/api/wards.html?province_code=01"

Provinces (Tỉnh/Thành)

{
  "code": "01",
  "name": "Thành phố Hà Nội",
  "type": "Thành phố Trung ương"
}

Query Parameters:

• ?code=01 - Tìm theo mã tỉnh/thành phố
• ?name=Hà Nội - Tìm theo tên tỉnh/thành phố (partial match, case-insensitive)

Wards (Phường/Xã)

{
  "code": "00001",
  "name": "Phường Phúc Xá",
  "district_code": "001",
  "province_code": "01"
}

Query Parameters:

• ?district_code=001 - Lọc theo mã quận/huyện
• ?province_code=01 - Lọc theo mã tỉnh/thành phố
• ?province_name=Hà Nội - Lọc theo tên tỉnh/thành phố