{"uid":"cap_R2Ifuke1Lan_YkPIuQE2I","slug":"ip-geo-api-my-ip-geolocation-7632d890","name":"IP Geo API – My IP Geolocation","description":"Geolocate the caller's own IP (derived from request headers); same fields as /lookup/ip.","url":"https://ip-geo-api-production.up.railway.app/lookup/myip","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":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ip":{"type":"string"},"asn":{"type":"string"},"isp":{"type":"string"},"org":{"type":"string"},"city":{"type":"string"},"found":{"type":"boolean"},"is_vpn":{"type":["boolean","null"]},"region":{"type":"string"},"source":{"type":"string"},"country":{"type":"string"},"is_proxy":{"type":["boolean","null"]},"latitude":{"type":"number"},"timezone":{"type":"string"},"longitude":{"type":"number"},"postal_code":{"type":"string"},"region_code":{"type":"string"},"country_code":{"type":"string"},"is_datacenter":{"type":"boolean"},"caller_ip_source":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_szsuj0szH68xGcTsc_7_U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geolocates the caller's own IP address (auto-detected from request headers), returning country, region, city, coordinates, timezone, ISP, ASN, VPN/proxy/datacenter flags, and more.","exampleAgentPrompt":"What's my current IP address and where is it located — give me the country, city, timezone, and whether it's flagged as a VPN or proxy.","exampleUseCases":[{"title":"Detect user's location for personalization","prompt":"Figure out where I'm connecting from right now — I need my country, city, and timezone so I can set up my dashboard defaults automatically."},{"title":"Check if connection looks like a VPN or proxy","prompt":"Can you check my current IP and tell me if it's being flagged as a VPN, proxy, or datacenter address? I want to verify how my traffic looks to external services."},{"title":"Log caller geo info for access audit","prompt":"Grab the geolocation details for whoever is making this request right now — I need their IP, country, region, ISP, and ASN for our access audit log."}],"resultDescription":"Returns a JSON object with the auto-detected IP address, country, country code, region, region code, city, postal code, latitude, longitude, timezone, ISP, organization, ASN, boolean flags for VPN/proxy/datacenter detection, the source of the geo data, and a 'caller_ip_source' field indicating how the IP was extracted from request headers.","failureModes":["IP cannot be determined from headers (e.g. missing forwarding headers) — may return found: false","IP is from a private/reserved range and cannot be geolocated — returns partial or empty geo fields","VPN/proxy detection fields may be null if detection data is unavailable for the IP","Service unavailable or payment failure — HTTP 402 or 5xx error"],"whenToPreferThis":"Use this endpoint when you need to geolocate the current caller/agent making the request without supplying an explicit IP address. It is ideal for self-identification scenarios, personalization pipelines, or security checks where the goal is to locate 'myself' rather than an arbitrary IP. Prefer the sibling /lookup/ip endpoint when you have a specific IP to query, or /lookup/batch for multiple IPs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:36.636Z","isFirstParty":false}