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

​
GET /api/districts/

Returns a list of districts in Nepal. Can be filtered by province using either province ID or province name.

​
Query Parameters

​
province_id
integer
The province ID to filter districts by. Returns all districts within the specified province.
​
province_name
string
The province name to filter districts by. Case-insensitive matching. Returns all districts within the specified province.
If neither province_id nor province_name is provided, all districts from all provinces are returned. If a province is not found, the API returns a 404 error.

​
Response

Returns an array of district objects.
​
id
integer
required
District ID
​
name
string
required
District name
​
area_sq_km
string
required
Area in square kilometers
​
website
string
required
District website URL
​
headquarter
string
required
District headquarter city

​
Response Example

[
  {
    "id": 1,
    "name": "Taplejung",
    "area_sq_km": "3646",
    "website": "https://taplejung.gov.np",
    "headquarter": "Phungling"
  },
  {
    "id": 2,
    "name": "Panchthar",
    "area_sq_km": "1241",
    "website": "https://panchthar.gov.np",
    "headquarter": "Phidim"
  },
  {
    "id": 3,
    "name": "Ilam",
    "area_sq_km": "1703",
    "website": "https://ilam.gov.np",
    "headquarter": "Ilam"
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us