Look up an IP address with the DB-IP free API
See more Geolocation Examples
Use the DB-IP v2 free service to retrieve country, state or province, and city without an API key. This example uses HTTPS, which returned a successful free lookup during verification on November 20, 2026. The provider documents a limit of 500 daily requests for the free service. Paid services provide additional fields and quotas.
Check errorCode before reading the location. Free results have a smaller field set, and the application should handle missing location values.
IP geolocation estimates a network location. VPNs, mobile gateways, and anycast routing can affect the result. City and coordinate fields can be missing or approximate. The sample address 8.8.8.8 is a public DNS address used to demonstrate the request.
Chilkat CkJava Downloads
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Use a public IP address. Provider results can change as their databases are updated.
String ipAddress = "8.8.8.8";
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
http.put_ConnectTimeout(10);
http.put_ReadTimeout(30);
http.put_Accept("application/json");
CkStringBuilder url = new CkStringBuilder();
url.Append("https://api.db-ip.com/v2/free/");
url.Append(http.urlEncode(ipAddress));
CkHttpResponse response = new CkHttpResponse();
success = http.HttpNoBody("GET",url.getAsString(),response);
if (response.get_StatusCode() == 0) {
// Request diagnostics can contain an API key. Report transport failure without logging credentials.
System.out.println("No HTTP response. Check connectivity, DNS, and TLS configuration.");
return;
}
CkJsonObject json = new CkJsonObject();
boolean parsed = json.Load(response.bodyStr());
if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
System.out.println("Lookup failed. HTTP " + response.get_StatusCode());
if (parsed == true) {
if (json.JsonTypeOf("errorCode") == 1) {
System.out.println(json.stringOf("errorCode"));
}
if (json.JsonTypeOf("error") == 1) {
System.out.println(json.stringOf("error"));
}
}
return;
}
if (parsed != true) {
System.out.println("Expected a JSON object in the lookup response.");
return;
}
if ((json.HasMember("errorCode") == true) || (json.JsonTypeOf("error") == 1)) {
System.out.println("The service could not complete the lookup.");
if (json.JsonTypeOf("errorCode") == 1) {
System.out.println(json.stringOf("errorCode"));
}
if (json.JsonTypeOf("error") == 1) {
System.out.println(json.stringOf("error"));
}
return;
}
if ((json.JsonTypeOf("ipAddress") != 1) || (json.StringOfEquals("ipAddress","",true) == true)) {
System.out.println("The response did not contain the expected IP address.");
return;
}
System.out.println("IP address: " + json.stringOf("ipAddress"));
if ((json.JsonTypeOf("countryName") == 1) && (json.StringOfEquals("countryName","",true) != true)) {
System.out.println("Country: " + json.stringOf("countryName"));
}
else {
System.out.println("Country: unavailable");
}
if ((json.JsonTypeOf("countryCode") == 1) && (json.StringOfEquals("countryCode","",true) != true)) {
System.out.println("Country code: " + json.stringOf("countryCode"));
}
else {
System.out.println("Country code: unavailable");
}
if ((json.JsonTypeOf("stateProv") == 1) && (json.StringOfEquals("stateProv","",true) != true)) {
System.out.println("State or province: " + json.stringOf("stateProv"));
}
else {
System.out.println("State or province: unavailable");
}
if ((json.JsonTypeOf("city") == 1) && (json.StringOfEquals("city","",true) != true)) {
System.out.println("City: " + json.stringOf("city"));
}
else {
System.out.println("City: unavailable");
}
}
}