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), Core, Standard, Business, and Enterprise

Our IP geolocation data is available with full access on our paid plans, and a country level geolocation version is offered in the Lite API plan. The full IP geolocation response provides the country, region/state, city, postal/zip code, geographic coordinates and timezone of the queried or current IP address. The Lite API geolocation response includes the country name, country code, continent name, and continent code.

Core, Standard, Business and Enterprise Plans

curl http://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 API

curl http://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), Core, 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.

Core, Standard, Business and Enterprise Plans

curl http://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 http://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 http://api.ipinfo.io/lite/8.8.8.8?token=$token

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

Privacy Data

Available in: Core (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 Core 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 http://ipinfo.io/164.90.184.99?token=$TOKEN

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

Core Plan

curl http://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 Core plan also contains IP to carrier information, flagging carrier IP addresses.

Standard, Business and Enterprise Plans

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

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

Core Plan

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

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

Anycast Information

curl http://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,
  ...