GET
/api/v1/provinces
Không cần khoá
Danh sách tỉnh/thành trước 1/7/2025
63 tỉnh/thành cũ, có phân trang và tìm theo từ khoá.
Tham số
keyword
string · query
Từ khoá tìm kiếm (có dấu hoặc không dấu)
limit
integer · query
Số kết quả mỗi trang
(mặc định 20)
page
integer · query
Số trang
(mặc định 1)
curl 'https://tinhthanhpho.com/api/v1/provinces' \
-H "Accept: application/json"const response = await fetch('https://tinhthanhpho.com/api/v1/provinces', {
headers: {
'Accept': 'application/json',
},
});
const data = await response.json();
console.log(data);<?php
$ch = curl_init('https://tinhthanhpho.com/api/v1/provinces');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);import requests
response = requests.get(
"https://tinhthanhpho.com/api/v1/provinces",
headers={"Accept": "application/json"},
timeout=10,
)
print(response.json())Phản hồi · 200 OK
{
"success": true,
"message": "Success",
"data": [
{
"province_id": 57,
"code": "89",
"name": "An Giang",
"type": "Tỉnh",
"created_at": null,
"updated_at": null,
"area_km2": null,
"population": null,
"district_count": 11
},
{
"province_id": 49,
"code": "77",
"name": "Bà Rịa - Vũng Tàu",
"type": "Tỉnh",
"created_at": null,
"updated_at": null,
"area_km2": null,
"population": null,
"district_count": 7
}
],
"metadata": {
"total": 63,
"page": 1,
"limit": 2,
"data_version": "2026.10.0"
}
}