Trust

How we classify an IP address

What each signal means and where it comes from, so you can set your own thresholds with confidence.

Location

City, region, country and coordinates come from DB-IP; the time zone is the zone of the nearest GeoNames city in the same country. Country-level answers are reliable for fixed broadband; city-level answers are approximate (typically the ISP's point of presence) and are least reliable for mobile networks, satellite links and corporate VPN egress. registered_country is where the block is registered with its regional registry, which can differ from where it is used.

Network

asn covers IPv4 and IPv6. asn_type classifies the operator (isp, hosting, mobile, education, government, business) from published facts first (cloud ranges, mobile carrier lists) and the operator name second.

Anonymisers

  • Tor: exact, from the Tor Project's exit list and relay consensus.
  • Privacy relays (iCloud Private Relay): exact, from Apple's published egress list. Relays carry ordinary consumers, so they are separated from commercial VPNs and always score low.
  • Commercial VPNs: operator-published server lists where available (named in vpn_name), plus curated VPN and datacenter ranges.
  • Residential proxies: detected from network behaviour and returned with a confidence score; only high-confidence detections add to the risk score.

Abuse

is_abuser is true for addresses on the DROP list of hijacked netblocks or listed as active botnet command-and-control servers by Feodo Tracker; threat_sources says which.

Risk score

A 0–100 score built from the signals above. Tor exits, hijacked netblocks, botnet command-and-control servers, bogons, residential proxies, VPNs and datacenter ranges raise it; mobile and residential networks lower it. Tor exits, DROP-listed netblocks and botnet C2 servers always score high, and privacy relays always score low. risk_factors lists what contributed to each answer.

Freshness

See data sources for each dataset's refresh cadence and last update; X-IpQuery-Data-Version on every response is the date of the oldest core dataset.