Find administrative units by name
find_unitsSearch Vietnamese administrative units by name or code, ignoring case and diacritics. scope "new" (default) searches the post-reform units (34 provinces, 3,321 communes); scope "old" searches units as of 30 June 2025 (63 provinces, districts, communes). Use to check spelling, get a code, or see every place with the same name before converting. Returns code, full name, level, match quality (code, exact, partial) and parent district/province. Examples: {"query":"Bến Nghé","scope":"old"}; {"query":"thu duc"}; {"query":"Tân Phú","scope":"old","level":"ward","province":"79","limit":20}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_units"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Restrict to one level. "district" exists only with scope "old". | |
| limit | No | Maximum results, 1-50, default 10. | |
| query | Yes | Unit name or code to look up, e.g. "Bến Nghé", "ben nghe", "Thủ Đức", "26734". Case and diacritics are ignored. | |
| scope | No | "new" (default): units after the 2025 reform (34 provinces, 3,321 communes). "old": units as of 30 June 2025 (63 provinces, districts, 10,035 communes). | |
| province | No | Optional province filter in the same scope: code or name. |