API Responses

Below is a description of all the information you'll get for the various plans we offer:

Free Plan

The free plan includes the geolocation information for an IP address and basic ASN details.

curl ipinfo.io/66.87.125.72/json?token=$TOKEN
{
  "ip": "66.87.125.72",
  "hostname": "ip-66-87-125-72.spfdma.spcsdns.net",
  "city": "Springfield",
  "region": "Massachusetts",
  "country": "US",
  "loc": "42.1015,-72.5898",
  "org": "AS10507 Sprint Personal Communications Systems",
  "postal": "01101",
  "timezone": "America/New_York"
}

If the IP is anycast or bogon an additional field is returned indicating that.

Basic Plan

In addition to higher request limit, the basic plan also includes more ASN details.

curl ipinfo.io/66.87.125.72/json?token=$TOKEN
{
  "ip": "66.87.125.72",
  "hostname": "ip-66-87-125-72.spfdma.spcsdns.net",
  "city": "Springfield",
  "region": "Massachusetts",
  "country": "US",
  "loc": "42.1015,-72.5898",
  "org": "AS10507 Sprint Personal Communications Systems",
  "postal": "01101",
  "timezone": "America/New_York",
  "asn": {
    "asn": "AS10507",
    "name": "Sprint Personal Communications Systems",
    "domain": "sprint.net",
    "route": "66.87.125.0/24",
    "type": "isp"
  }
}

The type field is one of either business, education, hosting or isp.

Standard Plan

In addition to higher request limit, the standard plan also includes privacy details.

curl ipinfo.io/8.8.8.8/json?token=$TOKEN
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "postal": "94043",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "business"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": false,
    "service": ""
  }
}

Business Plan

Our business plan includes access to multiple data fields besides ASN and geolocation, including privacy, abuse, company, carrier and limited domains hosted on the IP.

curl ipinfo.io/8.8.8.8/json?token=$TOKEN
{
  "ip": "66.87.125.5",
  "hostname": "ip-66-87-125-5.spfdma.spcsdns.net",
  "city": "Springfield",
  "region": "Massachusetts",
  "country": "US",
  "loc": "42.1015,-72.5898",
  "postal": "01101",
  "timezone": "America/New_York",
  "asn": {
    "asn": "AS10507",
    "name": "Sprint Personal Communications Systems",
    "domain": "sprint.pl",
    "route": "66.87.125.0/24",
    "type": "isp"
  },
  "company": {
    "name": "T-Mobile USA, Inc.",
    "domain": "t-mobile.com",
    "type": "isp"
  },
  "carrier": {
    "name": "T-Mobile",
    "mcc": "310",
    "mnc": "120"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": false,
    "service": ""
  },
  "abuse": {
    "address": "US, VA, Reston, 12524 Sunrise Valley Drive, 20196",
    "country": "US",
    "email": "deipaddy@sprint.com",
    "name": "Sprint IP Engineering",
    "network": "66.87.125.0/24",
    "phone": "+1-703-592-4850"
  },
  "domains": {
    "ip": "66.87.125.5",
    "total": 1,
    "domains": [
      "sisterinteriors.com"
    ]
  }
}

You can also query domains data separately. Check how you can find domains hosted on IP using Hosted Domains API.

curl ipinfo.io/domains/8.8.8.8?token=$TOKEN
{
  "ip": "8.8.8.8",
  "total": 11606,
  "domains": [
    "41.cn",
    "onionflix.cc",
    "newmax.info",
    "ftempurl.com",
    "itempurl.com"
  ]
}

Enterprise Plan

Our enterprise plan includes access to everything in business plan plus IP Whois, IP Ranges, IP Activity and full domains hosted on the IP.

IP Ranges API

curl ipinfo.io/ranges/comcast.net?token=$TOKEN
{
  "domain": "comcast.net",
  "num_ranges": "37330",
  "ranges": [
    "23.24.240.0/29",
    "23.24.240.64/29",
    "23.24.240.128/28",
    "23.24.240.152/29",
    "23.24.240.168/29",
    "23.24.240.192/29",
    "23.24.240.208/29",
    "23.24.241.40/29",
    "23.24.241.72/29",
    "23.24.241.96/29",
    "23.24.241.112/28",
    "23.24.241.136/29",
    "23.24.241.168/29",
    "23.24.241.184/29",
    ...
   ]
}

Hosted Domains API

The Hosted Domains API in the Enterprise plan includes higher limits. Whereas in the business plan, you can only get five domains per page, in the enterprise plan, you can get up to 1000 domains.

curl ipinfo.io/domains/8.8.8.8?token=$TOKEN
{
  "ip": "8.8.8.8",
  "total": "37330",
  "domains": [
    "41.cn",
    "onionflix.cc",
    "newmax.info",
    "ftempurl.com",
    "itempurl.com",
    "authrock.com",
    "ctempurl.com",
    "mtqnia.com",
    "server-panel.net",
    "gtempurl.com",
    "htempurl.com",
    ...
   ]
}