Lookup IP Address Get geolocation, ISP, and network details for any IPv4 or IPv6 address.
Endpoint Query Parameters IPv4 or IPv6 address to look up (e.g. 8.8.8.8)
Example Request curl -X GET "https://rocks.rive.wtf/api/ip?ip=8.8.8.8" \ -H "Authorization: Bearer YOUR_API_KEY"
Response Example { "data" : { "as" : "AS15169 Google LLC" , "asName" : "GOOGLE" , "city" : "Ashburn" , "country" : "United States" , "countryCode" : "US" , "hosting" : true , "ip" : "8.8.8.8" , "isp" : "Google LLC" , "lat" : 39.03 , "lon" : -77.5 , "mobile" : false , "org" : "Google Public DNS" , "proxy" : false , "region" : "VA" , "regionName" : "Virginia" , "timezone" : "America/New_York" , "zip" : "20149" }, "success" : true }
Response Fields Whether the lookup was successful
IP data object Full country name (e.g. "United States")
ISO 3166-1 alpha-2 country code (e.g. "US")
Region/state code (e.g. "VA")
Full region/state name (e.g. "Virginia")
IANA timezone identifier (e.g. "America/New_York")
Internet Service Provider name
Organization name associated with the IP
Autonomous System number and name (e.g. "AS15169 Google LLC")
Autonomous System name short form (e.g. "GOOGLE")
Whether the IP is a mobile/cellular connection
Whether the IP is a known proxy, VPN, or Tor exit node
Whether the IP belongs to a hosting provider or datacenter
Error Responses Status Meaning 400Missing or invalid ip parameter 404IP address not found or reserved (e.g. private ranges) 502Upstream ip-api.com request failed
ip-api.com has a free tier limit of 45 requests per minute per origin IP. If you exceed this, requests will return a 429 from the upstream and be surfaced as a 502. For higher throughput, consider caching results.
Private IP ranges (e.g. 192.168.x.x, 10.x.x.x, 127.0.0.1) will return a 404 as they cannot be geolocated.
