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

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.

Service documentation

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkHttpResponse.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Use a public IP address. Provider results can change as their databases are updated.
    const char *ipAddress = "8.8.8.8";
    CkHttp http;
    http.put_RequireSslCertVerify(true);
    http.put_ConnectTimeout(10);
    http.put_ReadTimeout(30);
    http.put_Accept("application/json");
    CkStringBuilder url;
    url.Append("https://api.db-ip.com/v2/free/");
    url.Append(http.urlEncode(ipAddress));
    CkHttpResponse response;
    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.
        std::cout << "No HTTP response. Check connectivity, DNS, and TLS configuration." << "\r\n";
        return;
    }

    CkJsonObject json;
    bool parsed = json.Load(response.bodyStr());
    if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
        std::cout << "Lookup failed. HTTP " << response.get_StatusCode() << "\r\n";
        if (parsed == true) {
            if (json.JsonTypeOf("errorCode") == 1) {
                std::cout << json.stringOf("errorCode") << "\r\n";
            }

            if (json.JsonTypeOf("error") == 1) {
                std::cout << json.stringOf("error") << "\r\n";
            }

        }

        return;
    }

    if (parsed != true) {
        std::cout << "Expected a JSON object in the lookup response." << "\r\n";
        return;
    }

    if ((json.HasMember("errorCode") == true) || (json.JsonTypeOf("error") == 1)) {
        std::cout << "The service could not complete the lookup." << "\r\n";
        if (json.JsonTypeOf("errorCode") == 1) {
            std::cout << json.stringOf("errorCode") << "\r\n";
        }

        if (json.JsonTypeOf("error") == 1) {
            std::cout << json.stringOf("error") << "\r\n";
        }

        return;
    }

    if ((json.JsonTypeOf("ipAddress") != 1) || (json.StringOfEquals("ipAddress","",true) == true)) {
        std::cout << "The response did not contain the expected IP address." << "\r\n";
        return;
    }

    std::cout << "IP address: " << json.stringOf("ipAddress") << "\r\n";
    if ((json.JsonTypeOf("countryName") == 1) && (json.StringOfEquals("countryName","",true) != true)) {
        std::cout << "Country: " << json.stringOf("countryName") << "\r\n";
    }
    else {
        std::cout << "Country: unavailable" << "\r\n";
    }

    if ((json.JsonTypeOf("countryCode") == 1) && (json.StringOfEquals("countryCode","",true) != true)) {
        std::cout << "Country code: " << json.stringOf("countryCode") << "\r\n";
    }
    else {
        std::cout << "Country code: unavailable" << "\r\n";
    }

    if ((json.JsonTypeOf("stateProv") == 1) && (json.StringOfEquals("stateProv","",true) != true)) {
        std::cout << "State or province: " << json.stringOf("stateProv") << "\r\n";
    }
    else {
        std::cout << "State or province: unavailable" << "\r\n";
    }

    if ((json.JsonTypeOf("city") == 1) && (json.StringOfEquals("city","",true) != true)) {
        std::cout << "City: " << json.stringOf("city") << "\r\n";
    }
    else {
        std::cout << "City: unavailable" << "\r\n";
    }
    }