GET
/api/v1/provinces
No key needed
Get list of provinces (before 1/7/2025)
Get list of provinces
Parameters
keyword
string · query
Search keyword
limit
integer · query
Number of results per page
(default 20)
page
integer · query
Page number
(default 1)
curl 'https://www.tinhthanhpho.com/api/v1/provinces' \
-H "Accept: application/json"const response = await fetch('https://www.tinhthanhpho.com/api/v1/provinces', {
headers: {
'Accept': 'application/json',
},
});
const data = await response.json();
console.log(data);<?php
$ch = curl_init('https://www.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://www.tinhthanhpho.com/api/v1/provinces",
headers={"Accept": "application/json"},
timeout=10,
)
print(response.json())Response · 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"
}
}