Locations

Overview

The first output is a searchable list of administrative locations in Uganda, all the way from regions down to villages which is available as:

1. Table - a searcheable and navigable list of locations
2. API endpoints to allow viewing the details of the locations

Roadmap

The road map for this is as below, feel free to send comments to opendata at ssmusoke.dev

1. Exporting the data into CSV
2. Adding more data elements to the locations - currently its only name and parent
3. Making the filters on the displayed list of locations dependent on each other, if a user selects one filter, the filters that follow it only contain the data related to that filter

API Code Examples

The hierarcy of the administrative regions is Region --> Sub-Region --> District --> County --> Sub-County --> Parish --> Village

Regions

List:

curl --location 'https://opendata.ssmusoke.dev/api/locations/regions/'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/regions/2'

                

Sub-regions

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-regions/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-regions?filter[region]=2'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-regions/6'

                

Districts

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/districts/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/districts?filter[subregion]=5'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/districts/24'

                

Counties

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/counties/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/counties?filter[district]=20'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/counties/50'

                

Sub-Counties

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-counties/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-counties?filter[county]=12'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/sub-counties/50'

                

Parishes

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/parishes/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/parishes?filter[subcounty]=25'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/parishes/100'

                

Villages

All:

curl --location 'https://opendata.ssmusoke.dev/api/locations/villages/'

                

Filtered:

curl --location 'https://opendata.ssmusoke.dev/api/locations/villages?filter[parish]=30'

                

Single:

curl --location 'https://opendata.ssmusoke.dev/api/locations/villages/250'