list_wards
Retrieve wards (Phường/Xã) for Vietnam's administrative units. Pass district_code (3-tier) or province_code (2-tier post-reform) to get the correct ward list.
Instructions
List wards (Phường/Xã). For level=3 (default, 3-tier) pass district_code obtained from list_districts. For level=2 (2-tier post-reform) pass province_code obtained from list_provinces({level:2}). Post-reform wards attach directly to province — their district_code is the sentinel "-1".
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_wards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Number of administrative tiers. 3 = pre-reform 63 tỉnh, Tỉnh→Quận→Phường (default when omitted). 2 = post-2025-07-01 34 tỉnh, Tỉnh→Phường (no district). For new addresses use level=2. | |
| district_code | No | District code from list_districts. Required for level=3 (3-tier schema, default). | |
| province_code | No | Province code. Required when level=2. |