{"uid":"cap_0WTy_x-pHDn2pQstBw4BM","slug":"ip-lookup-geolocation-asn-isp-proxy-status-94597e53","name":"IP Lookup – Geolocation, ASN, ISP & Proxy Status","description":"Geolocation, ASN, proxy and threat intelligence for any IP address.","url":"https://ipx402.com/v1/ip","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","minLength":3,"description":"IPv4 or IPv6 address to look up, e.g. \"8.8.8.8\"."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","IP"],"properties":{"IP":{"type":"object","required":["IP","valid"],"properties":{"IP":{"type":"string"},"asn":{"type":"string"},"isp":{"type":"string"},"city":{"type":"string"},"proxy":{"type":"object","properties":{"isp":{"type":"string"},"type":{"type":"string"},"domain":{"type":"string"},"city_name":{"type":"string"},"country_name":{"type":"string"}},"description":"Present when the address is a known proxy."},"valid":{"type":"boolean"},"alpha2":{"type":"string","description":"ISO country code."},"region":{"type":"string"},"country":{"type":"string"},"is_proxy":{"type":"boolean","description":"True when the address is a known proxy or VPN."},"latitude":{"type":"number"},"zip_code":{"type":"string"},"longitude":{"type":"number"},"time_zone":{"type":"string"},"ip_version":{"type":"integer"}},"description":"Geolocation, network and threat metadata for the address."},"code":{"type":"integer","description":"Upstream status code."},"success":{"type":"boolean","description":"Whether the lookup succeeded."}}}}}}},"responseSchema":{"type":"json","example":{"IP":{"IP":"8.8.8.8","asn":"62240","isp":"Clouvider Limited","city":"Dallas","valid":true,"country":"United States of America","is_proxy":false},"code":200,"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pYUrkFhFZ5rqsYhPeepjd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an IPv4 or IPv6 address to its geolocation, ASN, ISP, and proxy/VPN status","exampleAgentPrompt":"Can you look up the IP address 203.0.113.42 and tell me what country it's from, who the ISP is, and whether it's a known proxy or VPN?","exampleUseCases":[{"title":"Detect fraudulent signups by IP","prompt":"A user just signed up from IP 185.220.101.5 — can you check if that address is a proxy or VPN and tell me the country and ISP?"},{"title":"Geolocate visitor traffic for analytics","prompt":"I'm seeing a lot of traffic from IP 45.33.32.156 in my logs — where is it coming from geographically, and what ASN and ISP does it belong to?"},{"title":"Block suspicious proxy traffic","prompt":"Can you check whether IP 104.28.14.22 is a known proxy or VPN, and give me its country and ISP so I can decide whether to block it?"}],"resultDescription":"Returns a JSON object with the IP's validity flag, city, region, country, ISO alpha-2 country code, latitude, longitude, zip code, timezone, ASN, ISP name, IP version, a boolean is_proxy flag, and when applicable a proxy sub-object with proxy type, domain, city, and country.","failureModes":["Invalid or malformed IP address returns success: false with no geolocation data","Private/reserved IP ranges (e.g. 192.168.x.x) may return valid: false or empty geolocation","Unknown or unallocated IPs may return partial data with missing city/region fields","Network timeout or upstream service unavailability returns a non-200 code field","Payment failure (insufficient USDC balance) blocks the request before it reaches the lookup service"],"whenToPreferThis":"Choose this endpoint when you need a single-call resolution of an IP address into geolocation plus network metadata (ASN, ISP) plus proxy/VPN detection in one response. It covers both IPv4 and IPv6 and returns structured JSON ready for downstream use. Prefer this over raw WHOIS lookups when you need city-level geo data and proxy flagging combined, or over pure geo APIs when ISP and ASN context also matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:38.603Z","isFirstParty":false}