API Endpoints
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) : http://www.telize.com/ip

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

Example (Plain text) : http://ip.telize.com (Listen on both IPv4 and IPv6)
Example (Plain text) : http://ip4.telize.com (Listen on IPv4 only)
Example (Plain text) : http://ip6.telize.com (Listen on IPv6 only)

Usage example (Shell script) :


ip=$(curl -s http://www.telize.com/ip)
echo « My IP address is : $ip »

Output example :
IPv4 address :

IPv6 address :


JSON IP (Get IP address in JSON format) :

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

Example (JSON) : http://www.telize.com/jsonip
Example (JSONP) : http://www.telize.com/jsonip?callback=getip

Usage example :

Usage example (jQuery) :

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) : http://www.telize.com/geoip
Example (JSONP) : http://www.telize.com/geoip?callback=getgeoip

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

Example (JSON) : http://www.telize.com/geoip/
Example (JSONP) : http://www.telize.com/geoip/

Example (JSON) : http://www.telize.com/geoip/2a02:2770::21a:4aff:feb3:2ee
Example (JSONP) : http://www.telize.com/geoip/2a02:2770::21a:4aff:feb3:2ee?callback=getgeoip

Usage example :

Usage example (jQuery) :

JSON Output Schema

The output is a JSON object containing the following elements :

Please note that the IP location database may not contain all information about a given IP. In this case, only the available data is displayed.

ip (Visitor IP address, or IP address specified as parameter)
country_code (Two-letter ISO 3166-1 alpha-2 country code)
country_code3 (Three-letter ISO 3166-1 alpha-3 country code)
country (Name of the country)
region_code (Two-letter ISO-3166-2 state / region code)
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)
dma_code (DMA Code)
area_code (Area Code)
organization (ASN + ISP name)
timezone (Time Zone)
offset (UTC time offset)

Output example :

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

« ip »: « »,
« country_code »: « NL »,
« country_code3 »: « NLD »,
« country »: « Netherlands »,
« continent_code »: « EU »,
« latitude »: 52.5,
« longitude »: 5.75,
« dma_code »: « 0 »,
« area_code »: « 0 »,
« organization »: « AS196752 Tilaa V.O.F. »,
« timezone »: « Europe/Amsterdam »,
« offset »: « 2 »

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