API

CheckIP provides programmatic access to the API, including complete JSON response and individual filtered queries.

Authentication

API access is entirely anonymous and doesn't require authentication.

HTTPS connection

API is available only over a secure HTTPS connection with TLS v1.2 minimum. Connections over insecure HTTP protocol are automatically redirected to HTTPS.

# curl example to get your IP address over HTTPS curl https://checkip.info # curl example using `-L` option curl -L checkip.info # wget example wget -qO- checkip.info # HTTPie example http -Fb checkip.info

JSON response

# Ensure JSON response curl -L checkip.info/json # Or send 'Accept: application/json' header curl -LH 'Accept: application/json' checkip.info { "ip": "3.148.210.152", "hostname": "ec2-3-148-210-152.us-east-2.compute.amazonaws.com", "city": "Dublin", "region": "Ohio", "country": "US", "loc": "40.0992,-83.1141", "asn": { "asn": "AS16509", "name": "Amazon.com, Inc.", "route": "3.128.0.0/11" } }

Filtering

# ip curl -L checkip.info/ip => 3.148.210.152 # hostname curl -L checkip.info/hostname => ec2-3-148-210-152.us-east-2.compute.amazonaws.com # city curl -L checkip.info/city => Dublin # region curl -L checkip.info/region => Ohio # country curl -L checkip.info/country => US # loc curl -L checkip.info/loc => 40.0992,-83.1141 # asn curl -L checkip.info/asn { "asn": "AS16509", "name": "Amazon.com, Inc.", "route": "3.128.0.0/11" }

Rate limits

At this time, there are no enforced rate limits.