Sign in

v1

latestSwagger 2.02026-07-132830204.5 KB
Geolocation

IP Info

Get location information about an IP address and do reverse DNS (PTR) lookups

get/ip-info

Query parameters

ipstring required

An IPv4 or IPv6 address. Accepts standard IP notation and also CIDR notation

reverse-lookupboolean

Do a reverse DNS (PTR) lookup. This option can add extra delay to the request so only use it if you need it

Response

OK

validboolean required

True if this is a valid IPv4 or IPv6 address

countrystring required

Full country name

hostnamestring required

The IPs full hostname (only set if reverse-lookup has been used)

citystring required

Name of the city (if detectable)

country-codestring required

ISO 2-letter country code

latitudenumber double required

Location latitude

regionstring required

Name of the region (if detectable)

longitudenumber double required

Location longitude

continent-codestring required

ISO 2-letter continent code

ipstring required

The IPv4 or IPv6 address returned

country-code3string required

ISO 3-letter country code

currency-codestring required

ISO 4217 currency code associated with the country

host-domainstring required

The IPs host domain (only set if reverse-lookup has been used)

is-v6boolean required

True if this is a IPv6 address. False if IPv4

is-v4-mappedboolean required

True if this is a <a href="https://en.wikipedia.org/wiki/IPv6#IPv4-mapped_IPv6_addresses">IPv4 mapped IPv6 address</a>

is-bogonboolean required

True if this is a bogon IP address such as a private network, local network or reserved address

region-codestring required

ISO 3166-2 region code (if detectable)

language-codestring required

The ISO 2-letter language code for the official language spoken in the country

Example response

{
  "city": "Hong Kong",
  "continent-code": "AS",
  "country": "China, Hong Kong Special Administrative Region",
  "country-code": "HK",
  "country-code3": "HKG",
  "currency-code": "HKD",
  "host-domain": "",
  "hostname": "",
  "ip": "1.1.1.1",
  "is-bogon": false,
  "is-v4-mapped": false,
  "is-v6": false,
  "language-code": "zh",
  "latitude": 22.28552,
  "longitude": 114.15769,
  "region": "Hong Kong",
  "region-code": "HK",
  "timezone": {
    "abbr": "HKT",
    "date": "2025-11-18",
    "id": "Asia/Hong_Kong",
    "name": "Hong Kong Standard Time",
    "offset": "+08:00",
    "time": "12:05:01.242079452"
  },
  "valid": true
}