Lương tối thiểu vùng API
Tra vùng lương tối thiểu (vùng I–IV, mức tháng và giờ) của phường, xã mới, mã xã cũ trước 2025 hoặc cả tỉnh, cho năm 2026 và 2027.
Tra phường, xã, đặc khu thuộc vùng lương tối thiểu nào và mức lương tương ứng: NĐ 293/2025/NĐ-CP năm 2026 (5.310.000 / 4.730.000 / 4.140.000 / 3.700.000 đồng/tháng) và NĐ 399/2026/NĐ-CP từ 1/1/2027 (5.700.000 / 5.080.000 / 4.450.000 / 4.040.000 đồng/tháng). Phụ lục của cả hai nghị định đều liệt kê theo đơn vị hành chính mới sau 1/7/2025; cả 3.321 phường, xã đã được gắn mã, nên kết quả cho biết luôn vùng theo nghị định kế tiếp.
Gửi ward là tên (kèm province nếu tên trùng ở nhiều tỉnh) hoặc mã 5 chữ số, old_ward là mã xã cũ trước 2025 (chuyển đổi qua bảng sắp xếp chính thức, kể cả xã bị chia tách), hoặc chỉ province để xem các vùng và danh sách phường, xã từng vùng. Không có tham số thì trả về mức lương đang áp dụng; date để chọn ngày khác (mức lương có từ 1/7/2024).
Dữ liệu được dựng lại từ phụ lục nghị định bằng script đối chiếu từng tên với danh sách phường, xã.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
ward | query | string | không | Tên hoặc mã 5 chữ số của phường, xã hiện hành. | |
province | query | string | không | Tỉnh, thành (tên hoặc mã); nếu chỉ có tham số này thì liệt kê các vùng của tỉnh. | |
old_ward | query | string | không | Mã phường, xã cũ trước 2025. | |
date | query | string | không | Ngày áp dụng (mặc định hôm nay). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-min-wage?ward=Thục Phán&province=Cao Bằng" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-min-wage?ward=Thục Phán&province=Cao Bằng', {
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-min-wage?ward=Thục Phán&province=Cao Bằng",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-min-wage?ward=Thục Phán&province=Cao Bằng');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"date": "2026-11-11",
"results": [
{
"ward": "Phường Thục Phán",
"ward_code": "01273",
"province": "Tỉnh Cao Bằng",
"province_code": "04",
"region": "III",
"monthly": 4140000,
"hourly": 20000,
"from_next_decree": {
"region": "III",
"monthly": 4450000,
"hourly": 21400,
"effective_from": "2027-01-01"
}
}
],
"decree": "293/2025/NĐ-CP",
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"source": "https://lsvn.vn/danh-muc-dia-ban-ap-dung-muc-luong-toi-thieu-tu-ngay-01-01-2026-a165752.html",
"reviewed": "2026-11-11",
"upcoming": {
"decree": "399/2026/NĐ-CP",
"effective_from": "2027-01-01",
"monthly": {
"I": 5700000,
"II": 5080000,
"III": 4450000,
"IV": 4040000
},
"hourly": {
"I": 27400,
"II": 24400,
"III": 21400,
"IV": 19400
}
}
}
Ứng dụng
- Kiểm tra lương hợp đồng không thấp hơn lương tối thiểu trong phần mềm tiền lương
- Hiển thị vùng lương của nơi làm việc trong app nhân sự
- Tính mức trần trợ cấp thất nghiệp
- Trả lời câu hỏi "phường tôi thuộc vùng mấy" trong chatbot
Hỏi đáp
Có hỗ trợ phường, xã sau sáp nhập 2025 không?
Có: cả hai nghị định đều liệt kê đơn vị mới và mọi mã phường, xã hiện hành đều được gắn vùng. Mã xã cũ dùng tham số old_ward.
Tên phường trùng ở nhiều tỉnh thì sao?
Kết quả có ambiguous: true và danh sách các phường khớp; hãy thêm province hoặc dùng mã phường.
Nghị định nào áp dụng?
Nghị định có hiệu lực tại date: NĐ 293/2025 cho năm 2026, NĐ 399/2026 từ 1/1/2027. Vùng xác định theo nơi người sử dụng lao động (hoặc chi nhánh) hoạt động.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.