Skip to main content

Privacy Detection API (Standard)

Available in: IPinfo Enterprise

The IPinfo IP to Privacy Detection (Standard) API provides detection of anonymous IP addresses, identifying whether an IP is associated with a VPN, proxy, Tor network, relay service, or hosting provider. IPinfo uses multi-modal detection methods to detect anonymous IP addresses, which includes internet measurement, IP address behavior and characteristics, internet records metadata, etc.

Looking for a self-serve API instead? Our IPinfo Core (limited), IPinfo Plus, and IPinfo Max API tiers all include privacy detection data. See IP Privacy Detection Data for a comparison across all tiers.

Quick Reference

API Schema
JSON
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo IP to Privacy Detection (Standard) API Response",
  "description": "Schema for IPinfo IP to Privacy Detection (Standard) API response",
  "type": "object",
  "properties": {
    "vpn": {
      "type": "boolean",
      "description": "Indicates Virtual Private Network (VPN) service exit node IP address.",
      "example": true
    },
    "proxy": {
      "type": "boolean",
      "description": "Indicates an open web proxy IP address.",
      "example": false
    },
    "tor": {
      "type": "boolean",
      "description": "Indicates whether the IP address is a Tor exit node.",
      "example": false
    },
    "relay": {
      "type": "boolean",
      "description": "Indicates a location-preserving anonymous relay service.",
      "example": false
    },
    "hosting": {
      "type": "boolean",
      "description": "Indicates a hosting/cloud service/data center IP address.",
      "example": true
    },
    "service": {
      "type": "string",
      "description": "Name of the privacy service provider - includes VPN, Proxy, and Relay service provider names.",
      "example": "NordVPN"
    }
  }
}
FieldDescriptionExample
vpnIndicates Virtual Private Network (VPN) service exit node IP addresstrue
proxyIndicates an open web proxy IP addressfalse
torIndicates whether the IP address is a Tor exit node.false
relayIndicates a location-preserving anonymous relay servicefalse
hostingIndicates a hosting/cloud service/data center IP addresstrue
serviceName of the privacy service provider - includes VPN, Proxy, and Relay service provider namesNordVPN

Lookup IP addresses

Bash
curl https://ipinfo.io/193.42.96.221/privacy?token=$TOKEN
JSON
{
  "vpn": true,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": true,
  "service": "NordVPN"
}

In the case that the IP address is not an anonymous type or actively hosting IP anonymization technology (only a hosting-type IP), the respective detection metadata fields will not be present.

non-anonymous IP address
Bash
curl https://ipinfo.io/93.42.96.221/privacy?token=$TOKEN
JSON
{
  "vpn": false,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": false,
  "service": ""
}
Hosting (only) type IP address
Bash
curl https://ipinfo.io/2a02:6ea0:2700:1:1012:2a00:4028:0/privacy?token=$TOKEN
JSON
{
  "vpn": false,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": true,
  "service": ""
}

If you are using an IPv6 connection, please use the v6.ipinfo.io endpoint.

Was this page helpful?