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.infoJSON response
# Ensure JSON response
curl -L checkip.info/json
# Or send 'Accept: application/json' header
curl -LH 'Accept: application/json' checkip.info
{
"ip": "34.204.181.91",
"hostname": "ec2-34-204-181-91.compute-1.amazonaws.com",
"city": "Ashburn",
"region": "Virginia",
"country": "US",
"loc": "39.0438,-77.4874",
"asn": {
"asn": "AS14618",
"name": "Amazon.com, Inc.",
"route": "34.192.0.0/12"
}
}Filtering
# ip
curl -L checkip.info/ip
=> 34.204.181.91
# hostname
curl -L checkip.info/hostname
=> ec2-34-204-181-91.compute-1.amazonaws.com
# city
curl -L checkip.info/city
=> Ashburn
# region
curl -L checkip.info/region
=> Virginia
# country
curl -L checkip.info/country
=> US
# loc
curl -L checkip.info/loc
=> 39.0438,-77.4874
# asn
curl -L checkip.info/asn
{
"asn": "AS14618",
"name": "Amazon.com, Inc.",
"route": "34.192.0.0/12"
}
Rate limits
At this time, there are no enforced rate limits.