Neat Geo IP

Neat Geo IP simple & free IP to country API

View the Project on GitHub kasramp/neatgeoip

Welcome to Neat Geo IP

Neat Geo IP is a free and simple GeoIP API based on free version of GeoLite2-City database from MaxMind. The API helps you to retrieve the country of a provided IP address.

Some details

Neat Geo IP is a free GeoIP webservice which allows to retrieve country name of the given IP address. The service is based on the free version of GeoLite2-City database from MaxMind.
Our technology stack includes variety of Open source tools/technologies such as Spring Boot framework for development and Openshift for hosting the service.
The service is particularly optimized for Openshift. Since GeoLite2-City database is getting updated monthly, an Openshift specific bash script written to wipe out the current database and restart the service to download the latest database upon starting of the service. Hence, every time service is getting restarted, it automatically downloads the latest fresh database from MaxMind (if does not exist in local storage). Service has monthly down time between 5 to 10 minutes.

Getting started

For more details on the project structure, API and how to use it have a look at our documentation page.

License and terms & conditions

The source code of Neat Geo IP is available under GNU General Public License Version 3 (GPLv3) excluding Maxmind GeoLite2-City database. All the database rights belong to MaxMind, Inc (Copyright© 2012-2016). The database file is licensed by MaxMind and distributed under the Creative Commons Attribution-ShareAlike 4.0 International License.
This product includes GeoLite2 data created by MaxMind, available from

Authors and Contributors

This API is developed and maintained by Kasra Madadipouya (@kasramp). Anyone is welcome to contribute to this project. This page is hosted on Github pages.

Support or Contact

Facing any problems, found bugs or having any inquiries? Just drop an email to