{"uid":"cap_66903SwHsMZadAJpyVXsY","slug":"vendsdk-ip-geolocation-lookup-af7e7ea2","name":"VendSDK IP Geolocation Lookup","description":"Live IP geolocation: country, city, org, and ASN for fraud and routing agents","url":"https://vendsdk.com/api/v/ip-lookup","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ip":{"type":"string"},"ok":{"type":"boolean"},"org":{"type":"string"},"service":{"type":"string"},"country_code":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3UBb96-tjBeGQf7KbWCqF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns country, city, organization, and ASN for a given IPv4 or IPv6 address for fraud detection and routing decisions","exampleAgentPrompt":"Can you geolocate 203.0.113.42 for me — I need the country, city, org, and ASN to check if it looks legit before processing the transaction?","exampleUseCases":[{"title":"Fraud screening for suspicious login","prompt":"A user just logged in from 185.220.101.47 — can you look up where that IP is from, who owns it, and what ASN it belongs to so I can decide if it's a VPN or Tor exit node?"},{"title":"Traffic routing by country","prompt":"We're getting requests from 2001:4860:4860::8888 and need to route them to the right regional server — can you find out what country that IP is in?"},{"title":"Compliance geo-blocking check","prompt":"Before we serve this content, can you check what country IP 91.108.4.0 is registered in and which org owns it? We need to block certain regions per our licensing terms."}],"resultDescription":"Returns a JSON object containing the queried IP address, a boolean ok field indicating success, the organization name (org), country code, and a service identifier. Useful for quickly determining geographic origin and network ownership of any IPv4 or IPv6 address.","failureModes":["Invalid or malformed IP address returns an error or ok:false","Private/reserved IP ranges may return no geolocation data","Rate limiting or payment failure returns HTTP 402","Upstream geolocation database may have stale or missing entries for rare IP blocks","IPv6 coverage may be less precise than IPv4"],"whenToPreferThis":"Choose this endpoint when you need real-time IP geolocation enriched with organization and ASN data in a single lightweight call, especially for fraud screening or routing agents that need sub-second responses. Prefer it over batch geolocation services when processing one IP at a time inline with a transaction or request flow, and when you want a pay-per-call model rather than a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:27.287Z","isFirstParty":false}