IPinfo - Comprehensive IP address data, IP geolocation API and database

IPinfo Max API

The IPinfo Max API is our most comprehensive API service, building on all IPinfo Plus features with full anonymization coverage including residential proxy behavioral signals.

  • Geolocation information: City, Region/State, Country, Postal code etc. and accuracy radius and last change date.
  • ASN information: ASN (Autonomous System Number), AS Name, ASN Domain, ASN Type and last change date
  • Anonymous IP address: Identifies whether an IP address is associated with privacy services such as VPNs, proxies, Tor nodes, relay services, or residential proxies — including behavioral activity signals.
  • Carrier information: Provides details about the mobile carrier, including the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC).
  • Network flags: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

Quick Reference

API Schema
JSON
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo Max API Response",
  "description": "Schema for IPinfo Max API response",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address being queried.",
      "example": "154.202.74.115"
    },
    "hostname": {
      "type": "string",
      "description": "The hostname associated with the IP address.",
      "example": "generic.hostname.com"
    },
    "geo": {
      "type": "object",
      "description": "Geographic location information for the IP address.",
      "properties": {
        "city": {
          "type": "string",
          "description": "The city where the IP address is located.",
          "example": "Lille"
        },
        "region": {
          "type": "string",
          "description": "The region or state where the IP address is located.",
          "example": "Hauts-de-France"
        },
        "region_code": {
          "type": "string",
          "description": "The two-letter region code in ISO 3166 format.",
          "example": "HDF"
        },
        "country": {
          "type": "string",
          "description": "The country where the IP address is located.",
          "example": "France"
        },
        "country_code": {
          "type": "string",
          "description": "The ISO 3166 country code of the IP address.",
          "example": "FR"
        },
        "continent": {
          "type": "string",
          "description": "The continent where the IP address is located.",
          "example": "Europe"
        },
        "continent_code": {
          "type": "string",
          "description": "The two-letter continent code.",
          "example": "EU"
        },
        "latitude": {
          "type": "number",
          "description": "The latitude coordinate of the IP address location.",
          "example": 50.63297
        },
        "longitude": {
          "type": "number",
          "description": "The longitude coordinate of the IP address location.",
          "example": 3.05858
        },
        "timezone": {
          "type": "string",
          "description": "The local timezone of the IP address location, formatted according to the IANA Time Zone Database.",
          "example": "Europe/Paris"
        },
        "postal_code": {
          "type": "string",
          "description": "The postal or zip code associated with the IP address location.",
          "example": "59000"
        },
        "dma_code": {
          "type": "string",
          "description": "The Designated Market Area (DMA) code, representing a TV media market region.",
          "example": "59"
        },
        "geoname_id": {
          "type": "integer",
          "description": "The unique numerical identifier for geographic locations from Geonames.org.",
          "example": 2998324
        },
        "radius": {
          "type": "integer",
          "description": "The location accuracy radius in kilometers.",
          "example": 200
        },
        "last_changed": {
          "type": "string",
          "format": "date",
          "description": "The date when the IP address's location was last updated, in YYYY-MM-DD format (ISO-8601).",
          "example": "2025-06-15"
        }
      }
    },
    "as": {
      "type": "object",
      "description": "Autonomous System (AS) information for the IP address.",
      "properties": {
        "asn": {
          "type": "string",
          "description": "The Autonomous System Number (ASN) identifying the organization that owns or operates the IP address.",
          "example": "AS16276"
        },
        "name": {
          "type": "string",
          "description": "The official name of the Autonomous System (AS) organization.",
          "example": "OVH SAS"
        },
        "domain": {
          "type": "string",
          "description": "The official domain name of the Autonomous System (AS) organization.",
          "example": "ovhcloud.com"
        },
        "type": {
          "type": "string",
          "description": "The type of the Autonomous System (AS) organization, such as hosting, ISP, education, government, or business.",
          "example": "hosting",
          "enum": ["hosting", "isp", "education", "government", "business"]
        },
        "last_changed": {
          "type": "string",
          "format": "date",
          "description": "The date when the IP address's ASN was last updated, in YYYY-MM-DD format (ISO-8601).",
          "example": "2025-03-09"
        }
      }
    },
    "mobile": {
      "type": "object",
      "description": "Mobile carrier information for the IP address.",
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the mobile carrier organization.",
          "example": "dtac"
        },
        "mcc": {
          "type": "string",
          "description": "The Mobile Country Code (MCC) of the carrier.",
          "example": "520"
        },
        "mnc": {
          "type": "string",
          "description": "The Mobile Network Code (MNC) of the carrier.",
          "example": "05"
        }
      }
    },
    "anonymous": {
      "type": "object",
      "description": "Anonymity and privacy service detection information.",
      "properties": {
        "is_proxy": {
          "type": "boolean",
          "description": "Indicates whether the IP address is an open web proxy.",
          "example": false
        },
        "is_relay": {
          "type": "boolean",
          "description": "Indicates whether the IP address is part of an anonymous relay service, such as iCloud Private Relay.",
          "example": false
        },
        "is_tor": {
          "type": "boolean",
          "description": "Indicates whether the IP address is a TOR (The Onion Router) exit node.",
          "example": false
        },
        "is_vpn": {
          "type": "boolean",
          "description": "Indicates whether the IP address is a Virtual Private Network (VPN) exit node.",
          "example": false
        },
        "name": {
          "type": "string",
          "description": "The name of the privacy service provider, such as a VPN, Proxy, Relay, or Residential Proxy service.",
          "example": "SwiftProxy.io"
        },
        "last_seen": {
          "type": "string",
          "format": "date",
          "description": "The latest date this IP was detected as a VPN, Residential Proxy or other proxies.",
          "example" "2025-12-03",
          },
        },
        },
        "percent_days_seen": {
          "type": "integer",
          "description": "Percentage of the past 90 days this IP was seen as a residential proxy.",
          "example": 13
        }
      }
    },
    "is_anonymous": {
      "type": "boolean",
      "description": "Indicates whether the IP address is anonymous. true if the IP address is associated with an IP privacy service.",
      "example": true
    },
    "is_anycast": {
      "type": "boolean",
      "description": "Indicates whether the IP address is an anycast IP. true if the IP address maps to multiple physical servers.",
      "example": false
    },
    "is_hosting": {
      "type": "boolean",
      "description": "Indicates whether the IP address is an internet service hosting IP address.",
      "example": true
    },
    "is_mobile": {
      "type": "boolean",
      "description": "Indicates whether the IP address belongs to a mobile network.",
      "example": false
    },
    "is_satellite": {
      "type": "boolean",
      "description": "Indicates whether the IP address is part of a satellite internet connection.",
      "example": false
    }
  }
}
FieldDescriptionExample
ipThe IP address being queried.154.202.74.115
hostnameThe hostname associated with the IP address.generic.hostname.com
geocityThe city where the IP address is located.Lille
regionThe region or state where the IP address is located.Hauts-de-France
region_codeThe two-letter region code in ISO 3166 format.HDF
countryThe country where the IP address is located.France
country_codeThe ISO 3166 country code of the IP address.FR
continentThe continent where the IP address is located.Europe
continent_codeThe two-letter continent code.EU
latitudeThe latitude coordinate of the IP address location.50.63297
longitudeThe longitude coordinate of the IP address location.3.05858
timezoneThe local timezone of the IP address location, formatted according to the IANA Time Zone Database.Europe/Paris
postal_codeThe postal or zip code associated with the IP address location.59000
dma_codeThe Designated Market Area (DMA) code, representing a TV media market region.59
geoname_idThe unique numerical identifier for geographic locations from Geonames.org.2998324
radiusThe location accuracy radius in kilometers.200
last_changedThe date when the IP address's location was last updated, in YYYY-MM-DD format (ISO-8601).2025-06-15
asasnThe Autonomous System Number (ASN) identifying the organization that owns or operates the IP address.AS16276
nameThe official name of the Autonomous System (AS) organization.OVH SAS
domainThe official domain name of the Autonomous System (AS) organization.ovhcloud.com
typeThe type of the Autonomous System (AS) organization, such as hosting, ISP, education, government, or business.hosting
last_changedThe date when the IP address's ASN was last updated, in YYYY-MM-DD format (ISO-8601).2025-03-09
mobilenameThe name of the mobile carrier organization.dtac
mccThe Mobile Country Code (MCC) of the carrier.520
mncThe Mobile Network Code (MNC) of the carrier.05
anonymousis_proxyIndicates whether the IP address is an open web proxy.false
is_relayIndicates whether the IP address is part of an anonymous relay service, such as iCloud Private Relay.false
is_torIndicates whether the IP address is a TOR (The Onion Router) exit node.false
is_vpnIndicates whether the IP address is a Virtual Private Network (VPN) exit node.false
nameThe name of the privacy service provider, such as a VPN, Proxy, Relay, or Residential Proxy service.SwiftProxy.io
last_seenLatest date this IP was detected as a VPN, Residential Proxy and other proxies.2026-03-07
percent_days_seenPercentage of the past 90 days this IP was seen as a Residential Proxy, based on a 90-day window.13
is_anonymousIndicates whether the IP address is anonymous. true if the IP address is associated with an IP privacy service.true
is_anycastIndicates whether the IP address is an anycast IP. true if the IP address maps to multiple physical servers.false
is_hostingIndicates whether the IP address is an internet service hosting IP address.true
is_mobileIndicates whether the IP address belongs to a mobile network.false
is_satelliteIndicates whether the IP address is part of a satellite internet connection.false

Lookup IP addresses:

Bash
curl https://api.ipinfo.io/lookup/154.202.74.115?token=$TOKEN
JSON
{
  "ip": "154.202.74.115",
  "hostname": "generic.hostname.com",
  "geo": {
    "city": "Lille",
    "region": "Hauts-de-France",
    "region_code": "HDF",
    "country": "France",
    "country_code": "FR",
    "continent": "Europe",
    "continent_code": "EU",
    "latitude": 50.63297,
    "longitude": 3.05858,
    "timezone": "Europe/Paris",
    "postal_code": "59000",
    "dma_code": "59",
    "geoname_id": "2998324",
    "radius": 200,
    "last_changed": "2025-06-15"
  },
  "as": {
    "asn": "AS16276",
    "name": "OVH SAS",
    "domain": "ovhcloud.com",
    "type": "hosting",
    "last_changed": "2025-03-09"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false,
    "name": "SwiftProxy.io",
    "last_seen": "2026-03-07",
    "percent_days_seen": 13
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}

Get information on your or visitors' IP address:

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

The IPinfo Max also supports ASN lookups via the ASN API.

The API endpoint also supports explicit declaration of IP address connections (IPv4/IPv6).

DescriptionEndpoint typeEndpoint
General (Dual Stacked)Self / Client IPcurl https://api.ipinfo.io/lookup/me?token=$TOKEN
Lookup / Target IPcurl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN
IPv4Self / Client IPcurl https://v4.api.ipinfo.io/lookup/me?token=$TOKEN
Lookup / Target IPcurl https://v4.api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN
IPv6Self / Client IPcurl https://v6.api.ipinfo.io/lookup/me?token=$TOKEN
Lookup / Target IPcurl https://v6.api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

The general API endpoint is built to support both IPv4 and IPv6 connections, ensuring compatibility with either protocol.

Alternative API Schema

Our legacy API is still maintained with fresh data, and we are committed to providing continued service to existing customers.

IPinfo Standard (Legacy)

IPinfo Standard has been upgraded to the IPinfo Max API tier.

Bash
curl  https://ipinfo.io/8.8.8.8/json?token=$TOKEN
JSON
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "postal": "94043",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "business"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": false,
    "service": ""
  }
}
Was this page helpful?