01
Coverage
All 36 states plus the FCT, 774 LGAs, and 53,000+ towns.
V0.1.0 / SANDBOX_LIVE
Nigerian address data,
down to the towns.
A free, developer-first REST API for Nigerian location data. States, LGAs, wards, towns, and postal codes, structured and ready to query. No signup, no API key.
REST APIJSONEDGE READYMIT
...States
...LGAs
...Wards
53,000+Towns
Operational
API EXPLORER
Try it live.
Explore the API directly. Pick an endpoint, provide your parameters, and inspect the response from the live service.
API SANDBOX
Try the API
Explore available endpoints and see the response directly.
/api/states
List all states, optionally filtered by region.
Request parameters
Execute request
SPECIFICATION
What you get.
The details behind the API, so you know exactly what you're working with before writing any code.
02
Postal codes
Attached at the ward level, since NIPOST assigns codes per LGA and they're often shared across wards and towns. No fake one-to-one mapping.
03
Coordinates
Latitude and longitude included on states, LGAs, and towns. Optional on wards.
04
Search
One endpoint to search by name across states, LGAs, wards, or towns. Case-insensitive substring match.
05
Auth
None. No API key, no signup, no headers to set.
06
Also available as
A Python package (ng-address-toolkit) if you'd rather have the data offline, bundled with your app.
Built for Nigerian addressesDATA / API / OPEN