{"uid":"cap_uLIC-QDAisT7AhMkiiqDu","slug":"agentpay-geocode-forward-reverse-geocoding-via-x402-92762050","name":"AgentPay Geocode — Forward & Reverse Geocoding via x402","description":"Pay-per-call AI services via the 402 Payment Required protocol. No accounts, no API keys — just USDC on Base.","url":"https://agentpay.help/v1/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Place name, or 'lat,lon' for reverse lookup"},"reverse":{"type":"boolean","description":"Force reverse mode, optional"}}},"responseSchema":{"type":"json","example":{"count":1,"query":"Dubai","results":[{"lat":25.07725,"lon":55.30927,"name":"Dubai","country":"United Arab Emirates","timezone":"Asia/Dubai","population":3790000,"country_code":"AE"}],"reverse":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E7f5Gcyv5ZC1zWaWD8C2f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a place name or address to geographic coordinates (forward geocoding) or converts lat/lon coordinates to a place name (reverse geocoding), paid per-call in USDC with no API key required.","exampleAgentPrompt":"What are the latitude and longitude coordinates for Dubai, and what timezone is it in?","exampleUseCases":[{"title":"Enrich user location for personalization","prompt":"I have a user who typed 'Paris, France' as their city — can you get me the exact coordinates, timezone, and country code so I can configure their account?"},{"title":"Reverse geocode a GPS ping","prompt":"I got a GPS reading of lat 51.5074, lon -0.1278 — what city and country is that, and what's the local timezone?"},{"title":"Validate and enrich city name in a form","prompt":"A user submitted 'Osaka' as their city in our signup form — look it up and return the country, country code, population, and coordinates so I can store a normalized record."}],"resultDescription":"A JSON object with the original query, a results array containing matched places each with latitude, longitude, place name, country name, country code, timezone string, and population, plus the count of results and a reverse flag indicating the geocoding direction used.","failureModes":["Query string is empty or missing — returns validation error","Place name is ambiguous or misspelled — may return zero results or incorrect match","Coordinates provided in wrong format for reverse geocoding — parsing failure","Payment not sent or USDC balance insufficient — 402 Payment Required response, call not processed","Network timeout or service unavailability — no response or 5xx error"],"whenToPreferThis":"Choose this endpoint when you need a no-account, pay-per-call geocoding solution that supports both forward (place name to coordinates) and reverse (coordinates to place name) lookup in a single endpoint, especially in agent workflows where avoiding API key management matters and usage is infrequent or unpredictable. Prefer alternatives like Google Maps Geocoding or Nominatim if you need high-volume batch geocoding, street-level address precision, or structured address component parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:49.138Z","isFirstParty":false}