IP.SB Free API

IP (Get IP address in plain text format):

Returns the visitor IP address (IPv4 or IPv6) in plain text, useful for shell scripts or to find the external Internet routable address.

• Example (Plain text): https://api.ip.sb/ip
• Example (curl): curl ip.sb

Alternatively, for more granularity when querying from a dual-stack environments, the following endpoints are available:

• Example (Plain text): https://api.ip.sb/ip (Listen on both IPv4 and IPv6) or curl ip.sb
• Example (Plain text): https://api-ipv4.ip.sb/ip (Listen on IPv4 only) or curl -4 ip.sb or curl ipv4.ip.sb
• Example (Plain text): https://api-ipv6.ip.sb/ip (Listen on IPv6 only) or curl -6 ip.sb or curl ipv6.ip.sb

Usage example (Shell script):

#!/bin/sh

ip=$(curl -s https://api.ip.sb/ip)
echo "My IP address is: $ip"

Output example:

IPv4 address:

192.0.2.2

IPv6 address:

2001:db8::2

JSON IP (Get IP address in JSON format):

Returns the visitor IP address (IPv4 or IPv6) in a JSON object.

• Example (JSON): https://api.ip.sb/jsonip
• Example (JSONP): https://api.ip.sb/jsonip?callback=getip

Usage example:

<script type="application/javascript">
function getip(json){
    document.write("My IP address is: ", json.ip);
}
</script>

<script type="application/javascript" src="https://api.ip.sb/jsonip?callback=getip"></script>

Usage example (jQuery):

<script type="application/javascript">
$(document).ready(function() {
    $.getJSON("https://api.ip.sb/jsonip?callback=?",
        function(json) {
            document.write("My IP address is: ", json.ip);
        }
    );
});
</script>

GeoIP (Get IP address location in JSON format):

Calling the API endpoint without any parameter will return location information for the visitor IP address:

• Example (JSON): https://api.ip.sb/geoip
• Example (JSONP): https://api.ip.sb/geoip?callback=getgeoip

Appending an IP address as parameter will return location information for this IP address:

• Example (JSON): https://api.ip.sb/geoip/185.222.222.222
• Example (JSONP): https://api.ip.sb/geoip/185.222.222.222?callback=getgeoip

• Example (JSON): https://api.ip.sb/geoip/2a09::
• Example (JSONP): https://api.ip.sb/geoip/2a09::?callback=getgeoip

Usage example:

<script type="application/javascript">
function getgeoip(json){
    document.write("Geolocation information for IP address: ", json.ip);
    document.write("Country: ", json.country);
    document.write("Latitude: ", json.latitude);
    document.write("Longitude: ", json.longitude);
}
</script>

<script type="application/javascript" src="https://api.ip.sb/geoip?callback=getgeoip"></script>

Usage example (jQuery):

<script type="application/javascript">
$(document).ready(function() {
    $.getJSON("https://api.ip.sb/geoip?callback=?",
        function(json) {
            document.write("Geolocation information for IP address: ", json.ip);
            document.write("Country: ", json.country);
            document.write("Latitude: ", json.latitude);
            document.write("Longitude: ", json.longitude);
        }
    );
});
</script>

JSON Output Schema

The output is a JSON object containing the following elements:

• ip (Visitor IP address, or IP address specified as parameter)
• country_code (Two-letter ISO 3166-1 alpha-2 country code)
• country (Name of the country)
• region_code (Two-letter ISO-3166-2 state / region code for US and Canada, FIPS 10-4 region codes otherwise)
• region (Name of the region)
• city (Name of the city)
• postal_code (Postal code / Zip code)
• continent_code (Two-letter continent code)
• latitude (Latitude)
• longitude (Longitude)
• organization (ASN + ISP name)
• timezone (Time Zone)

Output example:

The following example use xTom server IP: city, region, and postal code information is not available and thus not present in the output JSON object:

{
    "ip": "185.255.55.55",
    "country_code": "NL",
    "country": "Netherlands",
    "continent_code": "EU",
    "latitude": 52.3824,
    "longitude": 4.8995,
	"asn": "3214",
    "organization": "xTom Limited",
    "timezone": "Europe/Amsterdam",
}

Errors

Client Errors

When incorrect user input is entered, the server returns an HTTP 400 Error (Bad Request), along with a JSON-encoded error message.

HTTP Error	Code	Message
400	401	Input string is not a valid IP address

Acknowledgment

This service includes GeoLite data created by MaxMind, available from maxmind.com.

Source Code modified from Telize