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.

Please note that:

Geolocation Data

Available in: IPinfo Lite (Limited), IPinfo Core, IPinfo Plus, IPinfo Business, and IPinfo Enterprise

IPinfo Lite

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

{
  // ...
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}

IPinfo Core

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

{
  // ...
  "geo": {
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "postal_code": "94043",
    "dma_code": "807",
    "geoname_id": "5375480",
    "radius": 50
  },
  // ...
}

IPinfo Plus (Includes radius and last_changed fields)

curl https://api.ipinfo.io/lookup/38.181.131.54?token=$TOKEN

{
  // ...
  "geo": {
    "city": "Harmony Garden",
    "region": "Eastern",
    "region_code": "",
    "country": "Hong Kong",
    "country_code": "HK",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 22.26573,
    "longitude": 114.2487,
    "timezone": "Asia/Hong_Kong",
    "postal_code": "999077",
    "geoname_id": "12719613",
    "radius": 100,
    "last_changed": "2025-02-09"
  }
  // ...
}

IPinfo Business and IPinfo Enterprise

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

ASN Data

Available in: IPinfo Lite (Limited), IPinfo Core, IPinfo Plus, IPinfo Business, and IPinfo Enterprise

Along with details ASN information, the paid API tiers provide access to the dedicated ASN API service returns information related to the ASN (Autonomous System Number) of the current or queried IP.

  • In the IPinfo Lite plan, the API will return the ASN, ASN Organization name, and ASN Domain name.
  • In the IPinfo Core and IPinfo Plus API tiers, you will have access to ASN, AS Organization name, ASN Domain name, and ASN type. This also includes access to the ASN API service (ASN → ASN Information).
  • In the IPinfo Business and IPinfo Enterprise API services, you will have ASN, AS Organization name, ASN Domain name, ASN type, and ASN route/prefix information for the queried IP address. This also includes access to the ASN API service for ASN Information.

IPinfo Lite

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

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

IPinfo Core

curl https://api.ipinfo.io/lookup/177.155.240.88?token=$TOKEN

  //...
{
  "as": {
    "asn": "AS52778",
    "name": "SANER TELECOM INFORMATICA LTDA ME",
    "domain": "vilanet.com.br",
    "type": "isp"
  }
  //...
}

IPinfo Plus

curl https://api.ipinfo.io/lookup/177.155.240.88?token=$TOKEN

  //...
{
  "as": {
    "asn": "AS52778",
    "name": "SANER TELECOM INFORMATICA LTDA ME",
    "domain": "vilanet.com.br",
    "type": "isp",
    "last_changed": "2025-03-09"
  }
  //...
}

IPinfo Business and IPinfo Enterprise

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.

IP Privacy Detection Data

Available in: IPinfo Core (Limited), IPinfo Plus, IPinfo Business, and IPinfo 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 IPinfo Business, and IPinfo Enterprise.
  • A limited response is available on the IPinfo Core plan, showing if the IP address is an anonymous IP and whether it belongs to a hosting or data center service.
  • IPinfo Plus returns information related to the anonymous IP. However, it does not mention the name of the service.

IPinfo Core

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

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

IPinfo Plus

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

{
  //...
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  //...
}

IPinfo Business and IPinfo Enterprise

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

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

Carrier or Mobile IP Data

Available in: IPinfo Core (Partial), IPinfo Plus, IPinfo Business, and IPinfo Enterprise

Carrier Data returns mobile or carrier-related information for the IP address.

  • In limited capability, IPinfo Core also contains IP to carrier information, flagging carrier IP addresses.
  • The full IP to Carrier response is available across the IPinfo Plus, IPinfo Business and IPinfo Enterprise, which include the mobile carrier's name, its country code (MCC), and network code (MNC).

IPinfo Core

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

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

IPinfo Plus

curl https://api.ipinfo.io/lookup/1.39.203.0?token=$TOKEN

{
  //...
  "mobile": {
    "name": "Vi India",
    "mcc": "404",
    "mnc": "22"
  }
  //...
}

IPinfo Business and IPinfo Enterprise

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

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

Company Data

Available in: IPinfo Business, and IPinfo 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: IPinfo Business, and IPinfo 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:

  • IPinfo Business tier: Up to 5 domains are returned per API request.
  • IPinfo 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 IPinfo Business and IPinfo Enterprise users have access to a total of 1,000 domain names. However, on the IPinfo 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: IPinfo Business, and IPinfo 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: IPinfo Lite, IPinfo Core, IPinfo Plus, IPinfo Business, and IPinfo 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",
  //...
}