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 PowerShell Downloads
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"
$success = $false
# Assumes Chilkat is unlocked. See Global Unlock Sample.
# Use a public IP address. Provider results can change as their databases are updated.
$ipAddress = "8.8.8.8"
$http = New-Object Chilkat.Http
$http.RequireSslCertVerify = $true
$http.ConnectTimeout = 10
$http.ReadTimeout = 30
$http.Accept = "application/json"
$url = New-Object Chilkat.StringBuilder
$url.Append("https://api.db-ip.com/v2/free/")
$url.Append($http.UrlEncode($ipAddress))
$response = New-Object Chilkat.HttpResponse
$success = $http.HttpNoBody("GET",$url.GetAsString(),$response)
if ($response.StatusCode -eq 0) {
# Request diagnostics can contain an API key. Report transport failure without logging credentials.
$("No HTTP response. Check connectivity, DNS, and TLS configuration.")
exit
}
$json = New-Object Chilkat.JsonObject
$parsed = $json.Load($response.BodyStr)
if (($success -ne $true) -or ($response.StatusCode -lt 200) -or ($response.StatusCode -ge 300)) {
$("Lookup failed. HTTP " + $response.StatusCode)
if ($parsed -eq $true) {
if ($json.JsonTypeOf("errorCode") -eq 1) {
$($json.StringOf("errorCode"))
}
if ($json.JsonTypeOf("error") -eq 1) {
$($json.StringOf("error"))
}
}
exit
}
if ($parsed -ne $true) {
$("Expected a JSON object in the lookup response.")
exit
}
if (($json.HasMember("errorCode") -eq $true) -or ($json.JsonTypeOf("error") -eq 1)) {
$("The service could not complete the lookup.")
if ($json.JsonTypeOf("errorCode") -eq 1) {
$($json.StringOf("errorCode"))
}
if ($json.JsonTypeOf("error") -eq 1) {
$($json.StringOf("error"))
}
exit
}
if (($json.JsonTypeOf("ipAddress") -ne 1) -or ($json.StringOfEquals("ipAddress","",$true) -eq $true)) {
$("The response did not contain the expected IP address.")
exit
}
$("IP address: " + $json.StringOf("ipAddress"))
if (($json.JsonTypeOf("countryName") -eq 1) -and ($json.StringOfEquals("countryName","",$true) -ne $true)) {
$("Country: " + $json.StringOf("countryName"))
}
else {
$("Country: unavailable")
}
if (($json.JsonTypeOf("countryCode") -eq 1) -and ($json.StringOfEquals("countryCode","",$true) -ne $true)) {
$("Country code: " + $json.StringOf("countryCode"))
}
else {
$("Country code: unavailable")
}
if (($json.JsonTypeOf("stateProv") -eq 1) -and ($json.StringOfEquals("stateProv","",$true) -ne $true)) {
$("State or province: " + $json.StringOf("stateProv"))
}
else {
$("State or province: unavailable")
}
if (($json.JsonTypeOf("city") -eq 1) -and ($json.StringOfEquals("city","",$true) -ne $true)) {
$("City: " + $json.StringOf("city"))
}
else {
$("City: unavailable")
}