CountryStateCity API
Maps & Geocoding Ā· Data Validation
CountryStateCity is a free, open-source geographic reference database exposed as a REST API, providing structured data for all 250 countries in the world, their states and provinces, and their cities and local government areas. For Nigerian developers, it is particularly valuable because it includes all 36 Nigerian states plus the Federal Capital Territory (FCT), all 774 Local Government Areas (LGAs), and major Nigerian cities providing the authoritative administrative geography of Nigeria in a machine-readable format.
CountryStateCity API Highlights
CountryStateCity API is verified for developer integrations in Nigeria and across African markets, providing documented endpoints, sandbox testing, and developer support.
API Key (Header: X-CSCAPI-KEY)
100 requests/hour on free plan.
Nigeria
Ghana
Kenya
AWSCountryStateCity API is best for:
Developers building registration forms, address pickers, and location dropdowns who need a structured global database of all countries, states/provinces, and cities with full Nigerian states and LGA data included.
- Free plan:100 requests/hour with API key
- Free npm/composer packages available for offline use
- No credit card required
CountryStateCity API Core Features & Capabilities
Features Included
Not Supported
Required Access Documents for CountryStateCity API
- API Key RegistrationOptionalRegister at countrystatecity.in to get a free API key. Alternatively, install the npm package (csc-js) for completely offline use with no API key needed.
Different CountryStateCity API use cases
- Nigerian Address Form with State and LGA Dropdowns:Use CountryStateCity to populate a dynamic three-tier dropdown (Country > State > LGA) for Nigerian user registration forms ensuring users select valid Nigerian states and local government areas from a validated list rather than typing free text.
- Multi-Country Checkout Form:Build a checkout form for a Nigerian e-commerce platform that ships internationally use CountryStateCity to dynamically populate state/province dropdowns when users select any of 250 countries, ensuring valid address entry for cross-border orders.
- Field Force App Location Picker:Build a location picker for Nigerian field agents (sales reps, delivery drivers, healthcare workers) that lets them quickly select their current state and LGA from a validated list, storing standardized location data for reporting and routing.
- Nigerian Business Directory with LGA Filtering:Build a business directory for Nigerian SMEs where users can filter by state and LGA using CountryStateCity's full 774 LGA dataset, enabling granular geographic search across Nigeria's administrative divisions.