{"uid":"cap_2tOA97vjbTFOIaLu2Xq1k","slug":"tollmint-geocoding-api-3d7bd583","name":"Tollmint Geocoding API","description":"An API that quotes its own price and takes payment in the same request. Built for autonomous agents: no account, no invoice, no human in the loop.","url":"https://api.tollmint.com/v1/ref/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":5,"maximum":10,"minimum":1},"query":{"type":"string","maxLength":500,"minLength":1,"description":"Free-form address or place name"},"country_codes":{"type":"array","items":{"type":"string","maxLength":2,"minLength":2},"maxItems":10,"description":"ISO 3166-1 alpha-2 codes to restrict the search"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0008","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.0008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6FlcvuTn0zdYjvOwIuLJl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-form address or place name into geographic coordinates and structured location data, billed per call via x402 micropayment.","exampleAgentPrompt":"Can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' and give me up to 3 results restricted to the US?","exampleUseCases":[{"title":"Pin delivery address on a map","prompt":"I need to geocode '221B Baker Street, London' — limit results to 1 and restrict to the UK so I can drop a pin on the map."},{"title":"Validate a user-submitted address","prompt":"A user just entered '350 Fifth Avenue, New York' as their shipping address — can you geocode it, restrict to US results, and return up to 5 matches so I can confirm it's a real location?"},{"title":"Resolve a landmark for route planning","prompt":"I want to route to the Eiffel Tower — can you geocode 'Eiffel Tower, Paris' with country code FR and return the top result with its coordinates?"}],"resultDescription":"A JSON array of up to `limit` geocoding results, each containing a place name, structured address components, and latitude/longitude coordinates corresponding to the queried address or place name.","failureModes":["Ambiguous or misspelled address returns low-confidence or zero results","country_codes filter too restrictive — eliminates all valid matches","query string exceeds 500 characters — validation error","limit out of range (below 1 or above 10) — schema validation error","Payment fails or x402 handshake is rejected — request is not processed","Network timeout or service unavailability — 5xx error"],"whenToPreferThis":"Choose this endpoint when your agent needs lightweight, per-call geocoding without managing API keys, billing accounts, or subscriptions — particularly in autonomous agent workflows where micropayment via x402 is already supported. It is well-suited for low-to-moderate geocoding volumes where paying $0.0008 per call is acceptable and no pre-registration overhead is tolerable. Prefer alternatives like Google Maps Geocoding API or Nominatim if you need high-volume bulk geocoding, richer place metadata, or want to avoid per-call payment infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:26.153Z","isFirstParty":false}