Tra mức phạt giao thông API
Tra lỗi vi phạm giao thông theo Nghị định 168/2024 (đã sửa đổi năm 2026): mức phạt, số điểm GPLX bị trừ, hình phạt bổ sung và điều khoản cụ thể.
API tra mức phạt giao thông tìm các hành vi vi phạm theo Nghị định 168/2024/NĐ-CP (hiệu lực từ 01/01/2025), đã được sửa đổi bởi Nghị định 238/2026/NĐ-CP (hiệu lực từ 15/8/2026). Gõ lỗi theo cách nói thông thường, có dấu hay không dấu đều được (vuot den do, nồng độ cồn, khong doi mu bao hiem, điện thoại) và lọc theo phương tiện với vehicle=car (ô tô), motorbike (xe máy), bicycle (xe đạp, xe đạp điện, xe thô sơ), pedestrian (người đi bộ), special (xe máy chuyên dùng) hoặc general; nếu câu tìm có tên xe (nong do con xe may) thì API tự lọc theo xe đó. Mỗi kết quả có khung tiền phạt (đồng), số điểm giấy phép lái xe bị trừ và điều khoản quy định việc trừ điểm, hình thức xử phạt bổ sung, biện pháp khắc phục hậu quả và trích dẫn chính xác điểm, khoản, Điều.
Lấy một mục bằng id hoặc trên đường dẫn (/v1/vn-traffic-fines/6.9.b, hoặc 6.9 cho cả khoản), liệt kê lỗi của một loại xe chỉ với vehicle, chỉ các lỗi bị trừ điểm với points=true, hoặc xếp theo mức phạt cao nhất với sort=fine.
Phạm vi: khoảng 350 hành vi phổ biến thuộc Điều 6–10, 12–21 và 34–36, nhập tay từ văn bản nghị định; chưa gồm các quy định chuyên sâu về kinh doanh vận tải và các điều về thẩm quyền xử phạt (gọi API không tham số để xem phạm vi). Mức phạt áp dụng với cá nhân; kết quả chỉ để tham khảo, không phải tư vấn pháp lý, và API không tra phạt nguội theo biển số.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
q | query | string | không | Hành vi vi phạm, có hoặc không dấu (vuot den do). | |
vehicle | query | string | không | car, motorbike, bicycle, pedestrian, special hoặc general (gõ o to, xe may cũng được). | |
id | path|query | string | không | Mã mục điều.khoản.điểm (6.9.b) hoặc một khoản (6.9). | |
article | query | number | không | Chỉ lấy một Điều của nghị định. | |
points | query | boolean | không | Chỉ các lỗi bị trừ điểm GPLX. | |
sort | query | string | không | fine để xếp theo mức phạt cao nhất. | |
limit | query | number | không | 20 | Số kết quả tối đa (1–400). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-traffic-fines?q=vuot%20den%20do&vehicle=car&limit=1" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-traffic-fines?q=vuot%20den%20do&vehicle=car&limit=1', {
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-traffic-fines?q=vuot%20den%20do&vehicle=car&limit=1",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-traffic-fines?q=vuot%20den%20do&vehicle=car&limit=1');
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ề
{
"decree": "168/2024/NĐ-CP",
"effective_from": "2025-01-01",
"amended_by": [
{
"decree": "238/2026/NĐ-CP",
"issued": "2026-06-26",
"effective_from": "2026-08-15"
}
],
"reviewed": "2026-11-11",
"disclaimer": "Reference only, transcribed by hand from the decree; check the official text (vbpl.vn) before relying on an amount. Fines are for individuals; organisations pay double unless fine_org_* says otherwise.",
"query": "vuot den do",
"vehicle": "car",
"count": 6,
"results": [
{
"id": "6.9.b",
"vehicle": "car",
"article": 6,
"clause": 9,
"point": "b",
"reference_vi": "Điểm b khoản 9 Điều 6 Nghị định 168/2024/NĐ-CP",
"reference_en": "Decree 168/2024/ND-CP, Article 6(9)(b)",
"behavior_vi": "Không chấp hành hiệu lệnh của đèn tín hiệu giao thông",
"behavior_en": "Running a red light / disobeying traffic signals",
"fine_min": 18000000,
"fine_max": 20000000,
"fine_text": "18.000.000 đ – 20.000.000 đ",
"licence_points": 4,
"licence_points_ref": "6.16.b",
"additional_vi": [],
"additional_ref": null,
"note": "Trường hợp gây tai nạn giao thông xử phạt theo khoản 10 Điều này."
}
],
"coverage": {
"entries": 351,
"by_vehicle": {
"car": 130,
"motorbike": 98,
"special": 60,
"bicycle": 33,
"pedestrian": 6,
"general": 24
},
"articles": [
6,
7,
8,
9,
10,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
34,
35,
36
]
}
}
Ứng dụng
- Giải thích mức phạt trong app tài xế, gọi xe, quản lý đội xe
- Trả lời câu hỏi luật giao thông trong chatbot
- Hiển thị số điểm bị trừ trong app ôn thi lái xe
- Đánh giá rủi ro cho sản phẩm bảo hiểm xe
Hỏi đáp
Đã cập nhật sửa đổi năm 2026 chưa?
Rồi. Nghị định 238/2026/NĐ-CP (hiệu lực 15/8/2026) bổ sung phạt cảnh cáo khi chở trẻ em không có thiết bị an toàn, sửa quy định về che biển số, người 16–18 tuổi đi xe mô tô và thêm một số lỗi vận tải.
API có tra phạt nguội theo biển số không?
Không. Phạt nguội do CSGT công bố trên cổng có captcha; API chỉ mô tả quy định xử phạt.
Tổ chức có bị phạt cùng mức không?
Không: mức phạt trong kết quả là của cá nhân; tổ chức bị phạt gấp đôi, trừ khi nghị định quy định riêng (fine_org_min / fine_org_max).
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.