{"uid":"cap_mW00zMl_t-SwwH9QlY6t4","slug":"toll402-ip-geolocation-64d27c03","name":"Toll402 IP Geolocation","description":"The OpenRouter for AI-agent tools: one gateway, one wallet, every capability. Built-in tools, community-forged tools and other x402 services, all paid per call in USDC via x402 (HTTP 402). No signup, no API key.","url":"https://toll402.dev/v1/t/ip_geolocate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__7M-Bqer7bqa7vuA9TqZ3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns country, region, city, timezone, and ASN metadata for a given IPv4 or IPv6 address using ipapi.co","exampleAgentPrompt":"Can you look up the country, city, timezone, and ASN for the IP address 8.8.8.8?","exampleUseCases":[{"title":"Fraud detection by IP origin","prompt":"I have a suspicious login from IP 185.220.101.47 — can you tell me what country, region, and ASN it's coming from so I can flag it?"},{"title":"Personalizing content by user timezone","prompt":"A user connected from IP 203.0.113.42 — what timezone and city are they in so I can show them localized content?"},{"title":"Filtering traffic by geography","prompt":"Can you geolocate the IP 91.108.4.1 and tell me what country and ASN it belongs to? I need to check if it falls in a restricted region."}],"resultDescription":"Returns a JSON object with geolocation fields for the given IP address, including country name and code, region, city, timezone identifier, and ASN (Autonomous System Number) information, sourced from ipapi.co.","failureModes":["Invalid or malformed IP address returns an error or empty result","Private/reserved IP ranges (e.g. 192.168.x.x, 127.0.0.1) may return no geolocation data","Rate limiting from the underlying ipapi.co service may cause failures under high load","Payment failure via x402 protocol will prevent the call from completing"],"whenToPreferThis":"Choose this endpoint when you need quick, structured geolocation and ASN metadata for a single IP address without managing your own ipapi.co credentials. It is ideal for lightweight enrichment tasks in agentic workflows where per-call micropayment via x402 is acceptable and you need country, region, city, timezone, and ASN in a single response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:05.613Z","isFirstParty":false}