{"uid":"cap_oEnpI6dq58QJZb_jvbocI","slug":"ip-geolocation-api-caller-ip-lookup-myip-7ba0ce2c","name":"IP Geolocation API – Caller IP Lookup (myip)","description":"IP geolocation, batch lookup, distance calculation, and caller-IP introspection with x402 payments.","url":"https://ipgeo.payapi.market/lookup/myip?utm_source=zero.xyz","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":{"type":"json","example":{"ip":"203.0.113.7","asn":"AS64500","isp":"Example ISP Ltd","org":"Example ISP Ltd","city":"London","found":true,"is_vpn":null,"region":"England","source":"ip-api.com","country":"United Kingdom","is_proxy":null,"latitude":51.5074,"timezone":"Europe/London","longitude":-0.1278,"postal_code":"EC1A 1BB","region_code":"ENG","country_code":"GB","is_datacenter":false,"caller_ip_source":"request headers"}},"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_J86qkG8Rg36_DfHosV9sW","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":"Returns geolocation data for the calling client's own IP address, including city, region, country, ISP, ASN, coordinates, timezone, and proxy/VPN/datacenter flags.","exampleAgentPrompt":"What city and country is my current IP address located in, and is it flagged as a VPN or proxy?","exampleUseCases":[{"title":"Detect caller's country for access control","prompt":"Can you check what country this request is coming from and whether the IP is using a VPN or proxy — I want to decide if I should restrict access?"},{"title":"Auto-fill timezone from client IP","prompt":"Figure out what timezone my machine is in based on my IP address so I can set my app's default timezone automatically."},{"title":"Debug ISP and ASN for my connection","prompt":"Tell me what ISP and ASN are associated with my current IP address, and where geographically it resolves to."}],"resultDescription":"Returns a JSON object with the detected IP address, city, region, country and country code, latitude/longitude, postal code, timezone, ISP name, ASN, organization, boolean flags for VPN/proxy/datacenter status, the upstream data source (e.g. ip-api.com), and how the caller IP was detected (e.g. request headers).","failureModes":["IP not found in geolocation database: 'found' field returns false with minimal data","VPN/proxy detection fields may return null if not determinable","Caller IP may be a NAT or load balancer IP rather than the true client if headers are not forwarded correctly","Payment failure via x402 protocol results in 402 response before geolocation data is returned"],"whenToPreferThis":"Use this endpoint when you need to geolocate the machine or client making the current API call without supplying an explicit IP address — it auto-detects the caller's IP from request headers. Prefer it over batch or explicit-IP endpoints when you want self-introspection of the calling agent's network identity, including VPN/proxy/datacenter detection and ISP/ASN details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:38:25.871Z","isFirstParty":false,"canonicalSlug":"ip-geolocation-api-caller-ip-lookup-myip-7ba0ce2c"}