Sample code for 30+ languages & platforms
PHP ActiveX Requires Chilkat v11.0.0+

Geolocation of IP Address

See more REST Examples

Retrieve country, state or province, and city for a public IP address using the DB-IP v2 free JSON API. This replaces the retired freegeoip.net request and the historical two-service comparison. The sample sends one HTTPS request, checks transport and service errors, and reads the returned fields.

DB-IP documents 500 daily requests for its free service. Its free HTTPS endpoint returned a successful lookup during verification on November 20, 2026. For other providers and authenticated services, see the Geolocation examples.

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.

Service documentation

Chilkat PHP ActiveX Downloads

PHP ActiveX
<?php

$success = 0;

//  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 COM("Chilkat.Http");
$http->RequireSslCertVerify = 1;
$http->ConnectTimeout = 10;
$http->ReadTimeout = 30;
$http->Accept = 'application/json';
$url = new COM("Chilkat.StringBuilder");
$url->Append('https://api.db-ip.com/v2/free/');
$url->Append($http->urlEncode($ipAddress));
$response = new COM("Chilkat.HttpResponse");
$success = $http->HttpNoBody('GET',$url->getAsString(),$response);
if ($response->StatusCode == 0) {
    //  Request diagnostics can contain an API key. Report transport failure without logging credentials.
    print 'No HTTP response. Check connectivity, DNS, and TLS configuration.' . "\n";
    exit;
}

$json = new COM("Chilkat.JsonObject");
$parsed = $json->Load($response->BodyStr);
if (($success != 1) or ($response->StatusCode < 200) or ($response->StatusCode >= 300)) {
    print 'Lookup failed. HTTP ' . $response->StatusCode . "\n";
    if ($parsed == 1) {
        if ($json->JsonTypeOf('errorCode') == 1) {
            print $json->stringOf('errorCode') . "\n";
        }

        if ($json->JsonTypeOf('error') == 1) {
            print $json->stringOf('error') . "\n";
        }

    }

    exit;
}

if ($parsed != 1) {
    print 'Expected a JSON object in the lookup response.' . "\n";
    exit;
}

if (($json->HasMember('errorCode') == 1) or ($json->JsonTypeOf('error') == 1)) {
    print 'The service could not complete the lookup.' . "\n";
    if ($json->JsonTypeOf('errorCode') == 1) {
        print $json->stringOf('errorCode') . "\n";
    }

    if ($json->JsonTypeOf('error') == 1) {
        print $json->stringOf('error') . "\n";
    }

    exit;
}

if (($json->JsonTypeOf('ipAddress') != 1) or ($json->StringOfEquals('ipAddress','',1) == 1)) {
    print 'The response did not contain the expected IP address.' . "\n";
    exit;
}

print 'IP address: ' . $json->stringOf('ipAddress') . "\n";
if (($json->JsonTypeOf('countryName') == 1) and ($json->StringOfEquals('countryName','',1) != 1)) {
    print 'Country: ' . $json->stringOf('countryName') . "\n";
}
else {
    print 'Country: unavailable' . "\n";
}

if (($json->JsonTypeOf('countryCode') == 1) and ($json->StringOfEquals('countryCode','',1) != 1)) {
    print 'Country code: ' . $json->stringOf('countryCode') . "\n";
}
else {
    print 'Country code: unavailable' . "\n";
}

if (($json->JsonTypeOf('stateProv') == 1) and ($json->StringOfEquals('stateProv','',1) != 1)) {
    print 'State or province: ' . $json->stringOf('stateProv') . "\n";
}
else {
    print 'State or province: unavailable' . "\n";
}

if (($json->JsonTypeOf('city') == 1) and ($json->StringOfEquals('city','',1) != 1)) {
    print 'City: ' . $json->stringOf('city') . "\n";
}
else {
    print 'City: unavailable' . "\n";
}


?>