Official client Libraries

read more

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, Standard, Business, 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": "54.246.228.58",
  "hostname": "ec2-54-246-228-58.eu-west-1.compute.amazonaws.com",
  "city": "Dublin",
  "region": "Leinster",
  "country": "IE",
  "loc": "53.3331,-6.2489",
  "org": "AS16509 Amazon.com, Inc.",
  "postal": "D02",
  "timezone": "Europe/Dublin"
}

ASN Data

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

ASN Data is information related to the ASN (Autonomous System Number) of the target IP. In the free plan, this takes the form of org field, which contains the ASN and the AS organization name.

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"
  }
  ...
}

You can learn more about the ASN API from its documentation page.

Privacy Data

Available in: Standard, Business, and Enterprise

Privacy Data or anonymous IP data returns various methods used to mask a user's true IP address, including VPN detection, proxy detection, tor usage, private relay 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 models 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,
    "relay": false,
    "hosting": false,
    "service": ""
  }
}

Carrier Data

Available in: Business, and Enterprise

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

curl "ipinfo.io/66.87.125.72?token=$TOKEN"

{
  ...
  "carrier": {
    "name": "Sprint Corporation",
    "mcc": "310",
    "mnc": "120"
  }
}

Company Data

Available in: Business, and Enterprise

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.

Hosted Domains Data

Available in: Business, and Enterprise

Hosted Domains Data returns the total count of domains being hosted on the IP address and a list of 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"
    ]
  }
}

The number of domains returned per API request depends on the user's pricing tier:

  • Business tier: Up to 5 domains are returned per API request.
  • Enterprise tier: Up to 1,000 domains are returned per API request.
  • Hosted Domains database download: Up to 1,000 domains are available per IP address entry.

Both Business and Enterprise users have access to a total of 1,000 domain names. However, on the Business tier, users must go through paginated records to access more domain names.

The documentation and API parameters for the Hosted Domains endpoint are available in the Hosted Domains API documentation section.

Abuse Contact Data

Available in: Business, and Enterprise

Abuse Contact Data is contact information (usually of the network administrator) which can be used to report IP addresses that are engaged in fraudulent/malicious 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"
  }
}

IP Type Data

Available in: Free, Basic, Standard, Business, and Enterprise.

If the IP address 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",
  ...
}