Pháp lý & Thủ tục gov/documents

Tìm trong danh mục văn bản quy phạm pháp luật đã đăng Công báo nước CHXHCN

Việt Nam — khoảng 26.000 văn bản, phủ từ năm 2010 tới nay. Lọc theo từ khoá (`q`), theo loại văn bản, theo cơ quan ban hành, theo năm ban hành, và theo khoảng NGÀY HIỆU LỰC. Kết quả phân trang, sắp xếp theo ngày ban hành giảm dần. Mỗi bản ghi gồm: số hiệu (`313/2026/NĐ-CP`), trích yếu, loại văn bản, cơ quan ban hành, ngày ban hành, ngày hiệu lực, số Công báo đã đăng cùng ngày của số đó, và hai cờ cho biết văn bản có bản điện tử PDF/DOCX hay không. LƯU Ý PHÁP LÝ: `ngay_hieu_luc` là ngày hiệu lực GHI TRÊN VĂN BẢN tại thời điểm ban hành. Nó KHÔNG phản ánh việc văn bản sau đó có bị sửa đổi, thay thế hay bãi bỏ hay không — endpoint này không trả lời được câu hỏi "văn bản còn hiệu lực không". Dịch vụ này KHÔNG lưu và KHÔNG phục vụ họ tên người ký văn bản, theo Luật Bảo vệ dữ liệu cá nhân số 91/2025/QH15 và Nghị định 356/2025/NĐ-CP.

GET https://api-tools.hitechcloud.vn/api/gov/documents Đã chép

Cần khoá API

Tham số

q string · truy vấn

Từ khoá, tối thiểu 3 ký tự. Nếu chuỗi bắt đầu bằng chữ số và có dấu gạch chéo hoặc gạch nối (313/2026) thì được hiểu là SỐ HIỆU và khớp đầu chuỗi; ngược lại khớp giữa chuỗi trên trích yếu.

type string · truy vấn

Lọc theo tên loại văn bản, ví dụ Nghị định, Thông tư, Luật. Lấy danh sách giá trị hợp lệ tại GET api/gov/document-types.

agency string · truy vấn

Lọc theo tên cơ quan ban hành, ví dụ Chính phủ, Bộ Tài chính. Lấy danh sách giá trị hợp lệ tại GET api/gov/agencies. Kiểm thieu_co_quan ở GET api/gov/status trước khi tin vào tổng số của bộ lọc này.

year integer · truy vấn

Lọc theo NĂM BAN HÀNH, bốn chữ số. Giá trị khác trả 422.

effective_from string · truy vấn

Chỉ lấy văn bản có ngày hiệu lực từ ngày này trở đi, dạng YYYY-MM-DD. Ghép với effective_to để trả lời câu hỏi "văn bản nào bắt đầu có hiệu lực trong khoảng này" — câu hỏi đó KHÁC với "văn bản nào mới ban hành".

effective_to string · truy vấn

Chỉ lấy văn bản có ngày hiệu lực đến ngày này, dạng YYYY-MM-DD.

page integer · truy vấn

Số trang, đếm từ 1. Mặc định 1.

per_page integer · truy vấn

Số bản ghi mỗi trang, 1–100. Mặc định 20.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

curl --location 'https://api-tools.hitechcloud.vn/api/gov/documents?q=GIA_TRI&type=GIA_TRI&agency=GIA_TRI&year=GIA_TRI&effective_from=GIA_TRI&effective_to=GIA_TRI&page=GIA_TRI&per_page=GIA_TRI' \ --header 'X-API-Key: $HITECH_API_KEY' \ --header 'Accept: application/json'

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/gov/documents', [ 'q' => 'GIA_TRI', 'type' => 'GIA_TRI', 'agency' => 'GIA_TRI', 'year' => 'GIA_TRI', 'effective_from' => 'GIA_TRI', 'effective_to' => 'GIA_TRI', 'page' => 'GIA_TRI', 'per_page' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/gov/documents", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "q": "GIA_TRI", "type": "GIA_TRI", "agency": "GIA_TRI", "year": "GIA_TRI", "effective_from": "GIA_TRI", "effective_to": "GIA_TRI", "page": "GIA_TRI", "per_page": "GIA_TRI", }, ) data = res.json()