{"uid":"cap_9NybgpjvH6lQ3iNPMayrf","slug":"ip-geolocation-lookup-49107d01","name":"IP Geolocation Lookup","description":"Live IP geolocation: country, city, org, and ASN for fraud and routing agents","url":"https://vending-machine-seven.vercel.app/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_krL0TrPv99PgTcZo9Jdat","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 look up the geolocation for IP address 203.0.113.42 — I need the country, city, org, and ASN to decide whether to flag this signup as suspicious?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the queried IP address, a boolean ok status, the organization name, service label, and country code. Enables agents to determine geographic origin and network ownership of any public IP address.","failureModes":["Invalid or private IP address returns error or empty result","IP not found in geolocation database returns partial data","Malformed IP string returns validation error","Rate limiting or payment failure blocks the request","IPv6 addresses may have less granular city-level data"],"whenToPreferThis":"Use this endpoint when you need lightweight, real-time IP geolocation enrichment — specifically country code, city, org name, and ASN — for fraud scoring, access routing, or compliance checks. Prefer this over a full WHOIS bundle when you only need geo and network attribution and want to minimize cost per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:34:27.271Z","isFirstParty":false}