Sample code for 30+ languages & platforms
SQL Server 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 SQL Server Downloads

SQL Server
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    DECLARE @iTmp1 int
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

    --  Assumes Chilkat is unlocked. See Global Unlock Sample.
    --  Use a public IP address. Provider results can change as their databases are updated.
    DECLARE @ipAddress nvarchar(4000)
    SELECT @ipAddress = '8.8.8.8'
    DECLARE @http int
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OASetProperty @http, 'RequireSslCertVerify', 1
    EXEC sp_OASetProperty @http, 'ConnectTimeout', 10
    EXEC sp_OASetProperty @http, 'ReadTimeout', 30
    EXEC sp_OASetProperty @http, 'Accept', 'application/json'
    DECLARE @url int
    EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @url OUT

    EXEC sp_OAMethod @url, 'Append', @success OUT, 'https://api.db-ip.com/v2/free/'
    EXEC sp_OAMethod @http, 'UrlEncode', @sTmp0 OUT, @ipAddress
    EXEC sp_OAMethod @url, 'Append', @success OUT, @sTmp0
    DECLARE @response int
    EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @response OUT

    EXEC sp_OAMethod @url, 'GetAsString', @sTmp0 OUT
    EXEC sp_OAMethod @http, 'HttpNoBody', @success OUT, 'GET', @sTmp0, @response
    EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 = 0
      BEGIN
        --  Request diagnostics can contain an API key. Report transport failure without logging credentials.

        PRINT 'No HTTP response. Check connectivity, DNS, and TLS configuration.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @url
        EXEC @hr = sp_OADestroy @response
        RETURN
      END
    DECLARE @json int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT

    DECLARE @parsed int
    EXEC sp_OAGetProperty @response, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @json, 'Load', @parsed OUT, @sTmp0
    EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
    EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp1 OUT
    IF (@success <> 1) or (@iTmp0 < 200) or (@iTmp1 >= 300)
      BEGIN

        EXEC sp_OAGetProperty @response, 'StatusCode', @iTmp0 OUT
        PRINT 'Lookup failed. HTTP ' + @iTmp0
        IF @parsed = 1
          BEGIN
            EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'errorCode'
            IF @iTmp0 = 1
              BEGIN
                EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'errorCode'
                PRINT @sTmp0
              END
            EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'error'
            IF @iTmp0 = 1
              BEGIN
                EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'error'
                PRINT @sTmp0
              END
          END
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @url
        EXEC @hr = sp_OADestroy @response
        EXEC @hr = sp_OADestroy @json
        RETURN
      END
    IF @parsed <> 1
      BEGIN

        PRINT 'Expected a JSON object in the lookup response.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @url
        EXEC @hr = sp_OADestroy @response
        EXEC @hr = sp_OADestroy @json
        RETURN
      END
    EXEC sp_OAMethod @json, 'HasMember', @iTmp0 OUT, 'errorCode'
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp1 OUT, 'error'
    IF (@iTmp0 = 1) or (@iTmp1 = 1)
      BEGIN

        PRINT 'The service could not complete the lookup.'
        EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'errorCode'
        IF @iTmp0 = 1
          BEGIN
            EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'errorCode'
            PRINT @sTmp0
          END
        EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'error'
        IF @iTmp0 = 1
          BEGIN
            EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'error'
            PRINT @sTmp0
          END
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @url
        EXEC @hr = sp_OADestroy @response
        EXEC @hr = sp_OADestroy @json
        RETURN
      END
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'ipAddress'
    EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'ipAddress', '', 1
    IF (@iTmp0 <> 1) or (@iTmp1 = 1)
      BEGIN

        PRINT 'The response did not contain the expected IP address.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @url
        EXEC @hr = sp_OADestroy @response
        EXEC @hr = sp_OADestroy @json
        RETURN
      END

    EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'ipAddress'
    PRINT 'IP address: ' + @sTmp0
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'countryName'
    EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'countryName', '', 1
    IF (@iTmp0 = 1) and (@iTmp1 <> 1)
      BEGIN

        EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'countryName'
        PRINT 'Country: ' + @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'Country: unavailable'
      END
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'countryCode'
    EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'countryCode', '', 1
    IF (@iTmp0 = 1) and (@iTmp1 <> 1)
      BEGIN

        EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'countryCode'
        PRINT 'Country code: ' + @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'Country code: unavailable'
      END
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'stateProv'
    EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'stateProv', '', 1
    IF (@iTmp0 = 1) and (@iTmp1 <> 1)
      BEGIN

        EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'stateProv'
        PRINT 'State or province: ' + @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'State or province: unavailable'
      END
    EXEC sp_OAMethod @json, 'JsonTypeOf', @iTmp0 OUT, 'city'
    EXEC sp_OAMethod @json, 'StringOfEquals', @iTmp1 OUT, 'city', '', 1
    IF (@iTmp0 = 1) and (@iTmp1 <> 1)
      BEGIN

        EXEC sp_OAMethod @json, 'StringOf', @sTmp0 OUT, 'city'
        PRINT 'City: ' + @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'City: unavailable'
      END

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @url
    EXEC @hr = sp_OADestroy @response
    EXEC @hr = sp_OADestroy @json


END
GO