Skip to content
instantgeo

invalid_ip

403. The ?ip= value could not be parsed as an IPv4 or IPv6 address.

{
  "error": {
    "code": "invalid_ip",
    "message": "\"10.0.0\" is not a valid IP address. Pass a single IPv4 or IPv6 address."
  }
}

Fix it

Pass exactly one address, unquoted and URL-encoded:

?key=ig_sk_yourkey&ip=203.0.113.7
?key=ig_sk_yourkey&ip=2001%3Adb8%3A%3A1

Common causes:

  • A list. One address per request; there is no batch form.
  • A hostname. Resolve it yourself first.
  • A port or CIDR suffix, such as 203.0.113.7:443 or 203.0.113.0/24.
  • A leading zero, such as 010.0.0.1. One address has one spelling, so that it works the same as a cache key and a rate-limit bucket.

Private and reserved ranges are accepted as valid. They will usually come back with null fields, which is not an error but a genuine absence, and the response carries "partial": true.