Skip to main content
curl -X GET https://your-app-url/api/municipalities/

​
GET /api/municipalities/

Returns a list of municipalities in Nepal. Can be filtered by province and/or district using either IDs or names.

​
Query Parameters

​
province_id
integer
The province ID to filter municipalities by. Returns all municipalities within the specified province.
​
province_name
string
The province name to filter municipalities by. Case-insensitive matching. Returns all municipalities within the specified province.
​
district_id
integer
The district ID to filter municipalities by. Must be used in combination with province_id or province_name.
​
district_name
string
The district name to filter municipalities by. Case-insensitive matching. Must be used in combination with province_id or province_name.
If no parameters are provided, all municipalities from all districts and provinces are returned.When using district_id or district_name, you must also specify either province_id or province_name. If a province or district is not found, the API returns a 404 error.

​
Response

Returns an array of municipality objects.
​
id
integer
required
Municipality ID
​
category_id
integer
required
Category ID indicating the type of municipality
​
name
string
required
Municipality name
​
area_sq_km
string
required
Area in square kilometers
​
website
string
required
Municipality website URL
​
wards
array
required
List of ward numbers within the municipality

​
Response Example

[
  {
    "id": 1,
    "category_id": 1,
    "name": "Phungling Municipality",
    "area_sq_km": "120.5",
    "website": "https://phunglingmun.gov.np",
    "wards": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
  },
  {
    "id": 2,
    "category_id": 2,
    "name": "Mikwakhola Rural Municipality",
    "area_sq_km": "85.3",
    "website": "https://mikwakhola.gov.np",
    "wards": [1, 2, 3, 4, 5, 6]
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us