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.
- Residential Proxy detection: Residential proxy information as well as time-bound behavioral activity and frequency metadata.
- 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": "1.0.126.158"
},
"hostname": {
"type": "string",
"description": "The hostname associated with the IP address. May be absent if no hostname is available.",
"example": "158.126.0.1.megaegg.ne.jp"
},
"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": "Izumo"
},
"region": {
"type": "string",
"description": "The region or state where the IP address is located.",
"example": "Shimane"
},
"region_code": {
"type": "string",
"description": "The ISO 3166-2 region code of the IP address.",
"example": "32"
},
"country": {
"type": "string",
"description": "The country where the IP address is located.",
"example": "Japan"
},
"country_code": {
"type": "string",
"description": "The ISO 3166-1 alpha-2 country code of the IP address.",
"example": "JP"
},
"continent": {
"type": "string",
"description": "The continent where the IP address is located.",
"example": "Asia"
},
"continent_code": {
"type": "string",
"description": "The two-letter continent code.",
"example": "AS"
},
"latitude": {
"type": "number",
"description": "The latitude coordinate of the IP address location.",
"example": 35.36667
},
"longitude": {
"type": "number",
"description": "The longitude coordinate of the IP address location.",
"example": 132.76667
},
"timezone": {
"type": "string",
"description": "The local timezone of the IP address location, formatted according to the IANA Time Zone Database.",
"example": "Asia/Tokyo"
},
"postal_code": {
"type": "string",
"description": "The postal or zip code associated with the IP address location. May be absent for some regions.",
"example": "693-0001"
},
"dma_code": {
"type": "string",
"description": "The Designated Market Area (DMA) code, representing a TV media market region. Applicable to US IPs only.",
"example": "501"
},
"geoname_id": {
"type": "string",
"description": "The unique identifier for the geographic location from Geonames.org.",
"example": "1861084"
},
"radius": {
"type": "integer",
"description": "The location accuracy radius in kilometers.",
"example": 50
},
"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": "2026-03-22"
}
}
},
"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": "AS18144"
},
"name": {
"type": "string",
"description": "The official name of the Autonomous System (AS) organization.",
"example": "Enecom,Inc."
},
"domain": {
"type": "string",
"description": "The official domain name of the Autonomous System (AS) organization.",
"example": "enecom.co.jp"
},
"type": {
"type": "string",
"description": "The type of the Autonomous System (AS) organization, such as hosting, ISP, education, government, or business.",
"example": "business",
"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": "2021-05-01"
}
}
},
"mobile": {
"type": "object",
"description": "Mobile carrier information for the IP address. Empty object if the IP is not a mobile carrier IP.",
"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": {
"name": {
"type": "string",
"description": "The name of the privacy service provider. When is_vpn is true, this reflects the VPN provider name. When is_res_proxy is true, it reflects the residential proxy service name. Absent when no privacy service is identified.",
"example": "Ping Proxies"
},
"last_seen": {
"type": "string",
"format": "date",
"description": "The last recorded date this IP was detected as a residential proxy, in YYYY-MM-DD format (ISO-8601). The timezone is UTC. Uses a rolling 7-day observation window. Only present when is_res_proxy is true.",
"example": "2026-03-29"
},
"percent_days_seen": {
"type": "integer",
"description": "The percentage of days the IP was active as a residential proxy in the last 7-day observation period. For example, a value of 63 means the IP was seen as a proxy on approximately 4 of the last 7 days. Only present when is_res_proxy is true.",
"minimum": 0,
"maximum": 100,
"example": 63
},
"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
},
"is_res_proxy": {
"type": "boolean",
"description": "Indicates whether the IP address is a Residential Proxy IP.",
"example": true
}
}
},
"is_anonymous": {
"type": "boolean",
"description": "Indicates whether the IP address is anonymous. true if any flag in the anonymous object is true, including is_res_proxy. Note: this differs from IPinfo Plus, where residential proxy data is not included.",
"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": false
},
"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
}
}
}
| Field | Description | Example | |
|---|---|---|---|
ip | The IP address being queried. | 1.0.126.158 | |
hostname | The hostname associated with the IP address. May be absent if no hostname is available. | 158.126.0.1.megaegg.ne.jp | |
geo | city | The city where the IP address is located. | Izumo |
region | The region or state where the IP address is located. | Shimane | |
region_code | The ISO 3166-2 region code of the IP address. | 32 | |
country | The country where the IP address is located. | Japan | |
country_code | The ISO 3166-1 alpha-2 country code of the IP address. | JP | |
continent | The continent where the IP address is located. | Asia | |
continent_code | The two-letter continent code. | AS | |
latitude | The latitude coordinate of the IP address location. | 35.36667 | |
longitude | The longitude coordinate of the IP address location. | 132.76667 | |
timezone | The local timezone of the IP address location, formatted according to the IANA Time Zone Database. | Asia/Tokyo | |
postal_code | The postal or zip code associated with the IP address location. May be absent for some regions. | 693-0001 | |
dma_code | The Designated Market Area (DMA) code, representing a TV media market region. Applicable to US IPs only. | 501 | |
geoname_id | The unique identifier for the geographic location from Geonames.org. | 1861084 | |
radius | The location accuracy radius in kilometers. | 50 | |
last_changed | The date when the IP address's location was last updated, in YYYY-MM-DD format (ISO-8601). | 2026-03-22 | |
as | asn | The Autonomous System Number (ASN) identifying the organization that owns or operates the IP address. | AS18144 |
name | The official name of the Autonomous System (AS) organization. | Enecom,Inc. | |
domain | The official domain name of the Autonomous System (AS) organization. | enecom.co.jp | |
type | The type of the Autonomous System (AS) organization, such as hosting, ISP, education, government, or business. | business | |
last_changed | The date when the IP address's ASN was last updated, in YYYY-MM-DD format (ISO-8601). | 2021-05-01 | |
mobile | name | The name of the mobile carrier organization. | dtac |
mcc | The Mobile Country Code (MCC) of the carrier. | 520 | |
mnc | The Mobile Network Code (MNC) of the carrier. | 05 | |
anonymous | name | The name of the privacy service provider. Reflects the VPN provider name when is_vpn is true, or the residential proxy service name when is_res_proxy is true. Absent when no privacy service is identified. | Ping Proxies |
last_seen | The last recorded date this IP was detected as a residential proxy, in YYYY-MM-DD format (ISO-8601). The timezone is UTC. Uses a rolling 7-day observation window. Only present when is_res_proxy is true. | 2026-03-29 | |
percent_days_seen | The percentage of days the IP was active as a residential proxy in the last 7-day observation period. For example, a value of 63 means the IP was seen as a proxy on approximately 4 of the last 7 days. Only present when is_res_proxy is true. | 63 | |
is_proxy | Indicates whether the IP address is an open web proxy. | false | |
is_relay | Indicates whether the IP address is part of an anonymous relay service, such as iCloud Private Relay. | false | |
is_tor | Indicates whether the IP address is a TOR (The Onion Router) exit node. | false | |
is_vpn | Indicates whether the IP address is a Virtual Private Network (VPN) exit node. | false | |
is_res_proxy | Indicates whether the IP address is a Residential Proxy IP. | true | |
is_anonymous | Indicates whether the IP address is anonymous. true if any flag in the anonymous object is true, including is_res_proxy. Note: residential proxy IPs are included in this flag in the Max API, unlike IPinfo Plus. | true | |
is_anycast | Indicates whether the IP address is an anycast IP. true if the IP address maps to multiple physical servers. | false | |
is_hosting | Indicates whether the IP address is an internet service hosting IP address. | false | |
is_mobile | Indicates whether the IP address belongs to a mobile network. | false | |
is_satellite | Indicates whether the IP address is part of a satellite internet connection. | false | |
Lookup IP addresses:
Bash
curl https://api.ipinfo.io/lookup/1.0.126.158?token=$TOKEN
JSON
{
"ip": "1.0.126.158",
"hostname": "158.126.0.1.megaegg.ne.jp",
"geo": {
"city": "Izumo",
"region": "Shimane",
"region_code": "32",
"country": "Japan",
"country_code": "JP",
"continent": "Asia",
"continent_code": "AS",
"latitude": 35.36667,
"longitude": 132.76667,
"timezone": "Asia/Tokyo",
"postal_code": "693-0001",
"geoname_id": "1861084",
"radius": 50,
"last_changed": "2026-03-22"
},
"as": {
"asn": "AS18144",
"name": "Enecom,Inc.",
"domain": "enecom.co.jp",
"type": "business",
"last_changed": "2021-05-01"
},
"mobile": {},
"anonymous": {
"name": "Ping Proxies",
"last_seen": "2026-03-29",
"percent_days_seen": 63,
"is_proxy": false,
"is_relay": false,
"is_tor": false,
"is_vpn": false,
"is_res_proxy": true
},
"is_anonymous": true,
"is_anycast": false,
"is_hosting": false,
"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).
| Description | Endpoint type | Endpoint |
|---|---|---|
| General (Dual Stacked) | Self / Client IP | curl https://api.ipinfo.io/lookup/me?token=$TOKEN |
| Lookup / Target IP | curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN | |
| IPv4 | Self / Client IP | curl https://v4.api.ipinfo.io/lookup/me?token=$TOKEN |
| Lookup / Target IP | curl https://v4.api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN | |
| IPv6 | Self / Client IP | curl https://v6.api.ipinfo.io/lookup/me?token=$TOKEN |
| Lookup / Target IP | curl 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.
Residential Proxy Time Window
The anonymous.last_seen and anonymous.percent_days_seen fields are scoped to a rolling 7-day observation window. This means:
last_seenreflects the most recent date within the last 7 days the IP was observed as a residential proxy.percent_days_seenreflects the share of those 7 days the IP was active. For example, a value of63means the IP was seen as a proxy on approximately 4 of the last 7 days.
For broader historical coverage, the Residential Proxy database download uses a 30-day observation window.
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?