Data Types

When you make a request to IPInfo using a token, the API returns all the data the token has access to for the target IP address. For instance, if you have access to Abuse Contact API, an abuse object will be sent in every response.

Geolocation Data

Available in: Free, Basic, Business, Premium, and Enterprise

The Geolocation Data is available in our free and paid plans. It includes country, region, city, and postal code of the target IP.

curl ipinfo.io?token=$TOKEN
{
  "ip": "183.87.70.24",
  "hostname": "24-70-87-183.mysipl.com",
  "city": "Pune",
  "region": "Maharashtra",
  "country": "IN",
  "loc": "18.5196,73.8554",
  "org": "AS45194 Syscon Infoway Pvt. Ltd.",
  "postal": "411005",
  "timezone": "Asia/Kolkata"
}

ASN Data

Available in: Free (Limited), Basic, Business, Premium, and Enterprise

The ASN data is information related to the ASN of the target IP. In the free plan, this takes the form of org field, which is basic ASN information.

Free Plan

curl ipinfo.io/8.8.8.8?token=$TOKEN
{
  ...
  "org": "AS15169 Google LLC",
  ...    
}

Paid Plan

curl ipinfo.io/8.8.8.8?token=$TOKEN
{
  ...
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "business"
  }
  ...
}

IP Type Data

Available in: Free, Basic, Business, Premium, and Enterprise

If the IP is an anycast or a bogon, the API returns a field indicating that.

Bogon Address Information

curl ipinfo.io/127.0.0.1?token=$TOKEN

{
  "ip": "127.0.0.1",
  "bogon": true
}

Anycast Information

curl ipinfo.io/8.8.8.8?token=$TOKEN

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  ...
}

Company Data

Available in: Business, Premium, Enterprise or as an add-on

Company Data identifies the name of the organization behind the IP, the type of business, and its domain . We source this information from various publicly available datasets.

curl ipinfo.io/8.8.8.8?token=$TOKEN
{
  ...
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "business"
  }
}

Note: The ability of IPInfo to tell the company depends on the size of the company and how it runs its network.

Suppose, WeWork NYC has rented its space to a startup. If someone from that startups visits your website, we might not be able to identify the company since it's small and uses its building's network. We will, however, be able to tell you that it's from WeWork.

Abuse Contact Data

Available in: Business, Premium, Enterprise or as an addon

Abuse Contact Data is contact information (usually of the network administrator) which can be used to report IPs that engaged in nefarious/spammy activites.

curl ipinfo.io/1.1.1.1?token=$TOKEN
{
  ...
  "abuse": {
    "address": "PO Box 3646, South Brisbane, QLD 4101, Australia",
    "country": "AU",
    "email": "abuse@apnic.net",
    "name": "APNIC RESEARCH",
    "network": "1.1.1.0/24",
    "phone": "+61-7-3858-3188"
  }
}

Privacy Data

Available in: Business, Premium, Enterprise or as an addon

Privacy Data returns various methods used to mask a user's true IP address, including VPN detection, proxy detection, tor usage, or a connection via a hosting provider, which could potentially be used to tunnel traffic, and mask the true IP address.

We perform custom full internet wide scans to detect almost 10 million active VPNs. This is combined with data on public SOCKS and HTTP proxies, tor exit nodes, and our own IP type detection to determine which IP ranges belong to hosting providers. The data is updated daily.

curl ipinfo.io/23.24.240.0?token=$TOKEN
{
  ...
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "hosting": false
  }
}

Carrier Data

Available in: Business, Premium, Enterprise or as an addon

Carrier Data returns mobile carrier related information for the IP address. This includes the carrier's name, it's country code (mcc) and network code (mnc).

curl "ipinfo.io/66.87.125.72?token=$TOKEN"
{
  ...
  "carrier": {
    "name": "Sprint Corporation",
    "mcc": "310",
    "mnc": "120"
  }
}

Hosted Domains Data

Available in: Business, Premium, Enterprise or as an addon

Hosted Domains Data returns the total count of domains being hosted on the IP address and a list of up to five domains.

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