Official client Libraries

read more

IP Data Types Developer Resource

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.

Geolocation Data

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

The IP geolocation data is available in our paid plans and in limited response in the Lite (free) plan. The full IP geolocation response includes the country, region, city, and postal code of the queried IP or the current IP address. The Lite plan IP geolocation response includes the country name, country code, continent name, and continent code.

Basic, Standard, Business and Enterprise Plans

curl https://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"
}

Lite Plan

curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN

{
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}

ASN Data

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

ASN Data returns information related to the ASN (Autonomous System Number) of the current or queried IP. In the paid plans, the API returns ASN, ASN organization name, ASN organization type (hosting, business, ISP, education, and government), ASN organization domain, and the prefix route for the IP address. In the Lite (free) plan, the API returns the ASN, ASN organization name, and ASN domain name.

Basic, Standard, Business and Enterprise Plans

curl https://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"
  }
  ...
}

In the paid plans, you also get access to the standalone ASN API service, which provides information on the queried ASN.

curl https://ipinfo.io/AS7922/json?token=$TOKEN

{
  "asn": "AS7922",
  "name": "Comcast Cable Communications, LLC",
  "country": "US",
  "allocated": "1997-02-14",
  "registry": "arin",
  "domain": "comcast.com",
  "num_ips": 71224576,
  "type": "isp",
  "prefixes": [
    {
      "netblock": "104.69.216.0/22",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    },
    {
      "netblock": "104.69.220.0/23",
      "id": "AKAMAI",
      "name": "Akamai Technologies, Inc.",
      "country": "US"
    }
  ],
  "prefixes6": [
    {
      "netblock": "2601::/20",
      "id": "COMCAST6NET",
      "name": "Comcast Cable Communications, LLC",
      "country": "US"
    },
    ...
  ]
}

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

Lite API Plan

curl https://api.ipinfo.io/lite/8.8.8.8?token=$token

{
  ...
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  ...
}

Privacy Data

Available in: Basic (Limited), 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. The full anonymous IP flag response—indicating whether an IP is a VPN, proxy, Tor exit node, relay, or hosting service—along with the name of the anonymous IP service provider, is available in the standard, business, and enterprise plans. A limited response is available on the Basic plan, showing if the IP address is an anonymous IP and whether it belongs to a hosting or data center service."

Standard, Business and Enterprise Plans

curl https://ipinfo.io/164.90.184.99?token=$TOKEN

{
  ...
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": "TunnelBear"
  }
  ...
}

Basic Plan

curl https://ipinfo.io/164.90.184.99?token=$TOKEN

{
  ...
  "is_anonymous": true,
  "is_hosting": true,
  ...
}

Carrier Data

Available in: Business, and Enterprise

Carrier Data returns mobile carrier-related information for the IP address. The full IP to Carrier response is available across the Business and Enterprise plans, which include the mobile carrier's name, its country code (MCC), and network code (MNC). In limited capability, the Basic plan also contains IP to carrier information, flagging carrier IP addresses.

Standard, Business and Enterprise Plans

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

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

Basic Plan

curl https://ipinfo.io/66.87.125.72?token=$TOKEN

{
  ...
  "is_mobile": true,
  ...
}

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 https://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 "https://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 https://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: Lite, 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 https://ipinfo.io/127.0.0.1?token=$TOKEN

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

Anycast Information

curl https://ipinfo.io/8.8.8.8?token=$TOKEN

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

In the Lite API tier, anycast IPs are identified with the is_anycast response flagged persistently with a true or false response.

  ...
  "is_anycast": false,
  ...