1. API List Regions

API Address​

GET: https://api.tiki.vn/directory/v1/countries/VN/regions

API Response​

Field	Type	Description
id	int	Region Id
name	string	Region name
tiki_code	string	Tiki region code
is_enabled	bool	Enable/Disable region

2. API List Districts​

API Address​

GET: https://api.tiki.vn/directory/v1/countries/VN/regions/{region_id}/districts

API Response​

Field	Type	Description
id	int	District Id
name	string	District name
tiki_code	string	Tiki district code
code	string	District code
is_enabled	bool	Enable/Disable district

3. API List Wards​

API Address​

GET: https://api.tiki.vn/directory/v1/countries/VN/regions/{region id}/districts/{district id}/wards

API Response​

Field	type	Description
id	int	Ward Id
name	string	Ward name
tiki_code	string	Tiki ward code
code	string	Ward code
is_enabled	bool	Enable/Disable ward
geo_lat	float	Latitude of ward
geo_long	float	Longitude of ward

4. Request Example​

Get the list of wards of District 5, Ho Chi Minh City https://api.tiki.vn/directory/v1/countries/VN/regions/294/districts/493/wards

Response Example​

{
  "data": [
    {
      "id": 10389,
      "code": "74240",
      "name": "Phường 01",
      "tiki_code": "VN039007001",
      "is_enabled": true,
      "geo_lat": 10.7655,
      "geo_long": 106.676003
    },
    {
      "id": 10390,
      "code": "74220",
      "name": "Phường 02",
      "tiki_code": "VN039007002",
      "is_enabled": true,
      "geo_lat": 10.763,
      "geo_long": 106.674004
    },
    {
      "id": 10391,
      "code": "74190",
      "name": "Phường 03",
      "tiki_code": "VN039007003",
      "is_enabled": true,
      "geo_lat": 10.7626,
      "geo_long": 106.671997
    },
    {
      "id": 10392,
      "code": "74170",
      "name": "Phường 04",
      "tiki_code": "VN039007004",
      "is_enabled": true,
      "geo_lat": 10.7642,
      "geo_long": 106.669998
    },
    {
      "id": 10393,
      "code": "74150",
      "name": "Phường 05",
      "tiki_code": "VN039007005",
      "is_enabled": true,
      "geo_lat": 10.7615,
      "geo_long": 106.667
    },
    {
      "id": 10394,
      "code": "74120",
      "name": "Phường 06",
      "tiki_code": "VN039007006",
      "is_enabled": true,
      "geo_lat": 10.7618,
      "geo_long": 106.664001
    },
    {
      "id": 10395,
      "code": "74110",
      "name": "Phường 07",
      "tiki_code": "VN039007007",
      "is_enabled": true,
      "geo_lat": 10.7622,
      "geo_long": 106.661003
    },
    {
      "id": 10396,
      "code": "74130",
      "name": "Phường 08",
      "tiki_code": "VN039007008",
      "is_enabled": true,
      "geo_lat": 10.7653,
      "geo_long": 106.666
    },
    {
      "id": 10397,
      "code": "74200",
      "name": "Phường 09",
      "tiki_code": "VN039007009",
      "is_enabled": true,
      "geo_lat": 10.7664,
      "geo_long": 106.670998
    },
    {
      "id": 10398,
      "code": "74020",
      "name": "Phường 10",
      "tiki_code": "VN039007010",
      "is_enabled": true,
      "geo_lat": 10.7684,
      "geo_long": 106.667999
    },
    {
      "id": 10399,
      "code": "74050",
      "name": "Phường 11",
      "tiki_code": "VN039007011",
      "is_enabled": true,
      "geo_lat": 10.7733,
      "geo_long": 106.678001
    },
    {
      "id": 10400,
      "code": "74030",
      "name": "Phường 12",
      "tiki_code": "VN039007012",
      "is_enabled": true,
      "geo_lat": 10.7752,
      "geo_long": 106.671997
    },
    {
      "id": 10401,
      "code": "74070",
      "name": "Phường 13",
      "tiki_code": "VN039007013",
      "is_enabled": true,
      "geo_lat": 10.7766,
      "geo_long": 106.667
    },
    {
      "id": 10402,
      "code": "74000",
      "name": "Phường 14",
      "tiki_code": "VN039007014",
      "is_enabled": true,
      "geo_lat": 10.7732,
      "geo_long": 106.661003
    },
    {
      "id": 10403,
      "code": "74090",
      "name": "Phường 15",
      "tiki_code": "VN039007015",
      "is_enabled": true,
      "geo_lat": 10.7821,
      "geo_long": 106.664001
    }
  ]
}