Temi Kolawole Nigeria Geo API
Temi Kolawole Nigeria Geo API is an open-source Nigerian geographic hierarchy dataset published on GitHub by Nigerian developer Temi Kolawole, providing structured JSON data covering all 36 Nigerian states plus the Federal Capital Territory (Abuja), all 774 Local Government Areas (LGAs) under each state, ward-level subdivisions for each LGA, and GPS coordinates for locations. This freely available dataset fills a critical gap for Nigerian app developers who need structured Nigerian administrative geography data — state-LGA-ward hierarchies — for building address forms, delivery zone configurations, geographic filters, field survey forms, and location-based features in Nigerian applications.
Nigerian address forms have historically been one of the most frustrating UX challenges in Nigerian app development because no authoritative, developer-ready dataset of Nigerian states, LGAs, and wards was publicly available in a machine-readable format. Apps either resorted to free-text address input (leading to inconsistent data), or developers manually compiled partial lists that missed LGAs or contained errors. The Temi Kolawole dataset solves this by providing a complete, verified JSON structure of the entire Nigerian administrative hierarchy that developers can embed directly into their applications.
State and LGA dropdown selectors are the most common integration of this dataset. Nigerian e-commerce platforms, delivery services, healthcare registration portals, and government applications collect structured Nigerian addresses by presenting a State dropdown that filters to the LGAs within the selected state, and optionally a Ward dropdown for more precise location selection. Using the Temi Kolawole dataset ensures that every Nigerian state and every LGA is represented accurately, with correct LGA assignments to each state — preventing common errors like misassigning an LGA to the wrong state.
Delivery zone configuration for Nigerian logistics companies uses the LGA-level data with coordinates to define service coverage areas. A courier company serving Lagos State can configure its delivery zones by Lagos LGAs — Eti-Osa, Surulere, Alimosho, Lagos Island, Kosofe, etc. — using the dataset's LGA list to populate zone management tools. The GPS coordinates per location enable mapping these zones on a leaflet or Google Maps interface for visual zone management.
Field survey and data collection applications used by NGOs, research institutions, and government agencies conducting surveys across Nigeria use the state-LGA-ward hierarchy to structure their geographic data collection. Field workers complete digital survey forms with geographic location selected from standardized dropdowns rather than free-text, ensuring consistent location data that can be aggregated and analyzed at state, LGA, or ward level. Organizations like UNICEF, WHO, and Nigerian state health agencies running household surveys benefit from consistent Nigerian administrative geography in their data collection tools.
Electoral and political analysis applications tracking Nigerian election results by state, senatorial district, federal constituency, LGA, and ward use this geographic hierarchy as the foundation for their analysis data structures. Nigerian political journalism, election monitoring organizations, and civic tech platforms analyzing INEC results data need accurate LGA and ward boundaries to correctly aggregate and display election results.
The dataset is hosted as a JSON file on GitHub and accessed by fetching the raw file URL — there is no traditional API server with request limits. It is completely free with no API key, no registration, and no rate limits. Developers embed the JSON directly in their application or fetch it at startup. The open-source nature means it can be modified, extended, and redistributed. Nigerian developers are encouraged to contribute corrections or updates through the GitHub repository if they identify any data inaccuracies in LGA lists or coordinates.