CheckIP Service (V3)

Dyn.rs offers a free web IP detection tool for use with our services. CheckIP will return the remote socket’s IP address. If a client sends a X-Forwarded-For HTTP header, CheckIP will return that value instead.

Hostname: dyn.rs
URI: /checkip
or /c for backwards compatibility with v2
Methods: GET
HTTP Ports: 80, 8245
HTTPS Port: 443

Additional parameters

format html (default for v3), text (default for v2) or json
callback When using the json format, you can specify the callback name in which case you will get a JSONP response.

Call and Answer

CheckIP responds to valid HTTP requests for https://dyn.rs/checkip. A valid request will result in the following sample response:

HTTP/1.1 200 OK
Server: nginx
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
Cache-Control: no-cache, private
X-RateLimit-Limit: 15
X-RateLimit-Remaining: 14

<html><head><title>Current IP Check</title></head><body>Current IP Address: 123.23.321.32</body></html>

Calling https://dyn.rs/c, as well as https://dyn.rs/checkip?format=text will return just an IP address in the response body:

123.23.321.32

JSON: https://dyn.rs/checkip?format=json:

{"ip":"123.23.321.32"}

JSONP: https://dyn.rs/checkip?format=json&callback=my_return:

/**/my_return({"ip":"123.23.321.32"});

Policies

  • Use the OS if possible for IP detection
  • Checks must be spaced at least 5 minutes apart to help reduce server load. The number of requests are limited to a maximum of 15 per hour.
  • In the case of an error while accessing CheckIP, the client should not send an update.