{"uid":"cap_-BGXN8dssqf9It3nEyL_Q","slug":"mapbox-reverse-geocoding-via-locus-x402-9479bd41","name":"Mapbox Reverse Geocoding via Locus x402","description":"Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.","url":"https://mapbox.x402.paywithlocus.com/mapbox/geocode-reverse","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number"},"types":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"worldview":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00375","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.00375/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00375","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00375","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PQ5-MkhbkPNv877JV8VaQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00375","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts geographic coordinates (latitude/longitude) into human-readable place names and addresses using Mapbox's reverse geocoding API, billed per call via x402 micropayments.","exampleAgentPrompt":"What street address or place name is at latitude 40.7128, longitude -74.0060? Give me up to 2 results in English, filtered to the US only.","exampleUseCases":[{"title":"GPS log address annotation","prompt":"I have a list of GPS coordinates from our delivery driver's route — can you look up the street address for the point at latitude 37.7749, longitude -122.4194, limited to US results?"},{"title":"Field report location labeling","prompt":"We just received a sensor reading from coordinates 51.5074 latitude, -0.1278 longitude in the UK — what's the nearest named address or place there so I can label the report?"},{"title":"User check-in place resolution","prompt":"A user checked in at lat 48.8566, lon 2.3522 — can you reverse geocode that to get the neighborhood or district name in French, limiting to France?"}],"resultDescription":"Returns a JSON object with a 'data' field containing Mapbox geocoding feature(s) — each including the matched place name, full address, administrative hierarchy, feature type, and geographic bounding box — plus payment settlement details (settled USDC amount) and a request tracking ID with a status URL.","failureModes":["Invalid coordinates (latitude outside -90 to 90 or longitude outside -180 to 180) return an error","Limit value outside 1-5 range may be rejected or clamped","No results found for remote or ocean coordinates — empty feature collection returned","Payment failure or insufficient balance returns a 402 error","Invalid country code or language tag returns a bad request error","Unsupported worldview code may return an error"],"whenToPreferThis":"Choose this endpoint when you need pay-per-call reverse geocoding without a monthly subscription, particularly in agent workflows where Mapbox geocoding quality is required and you want micropayment billing via x402/USDC. Prefer this over direct Mapbox API access when you don't have a Mapbox API key or need usage-based pricing at $0.00375 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:43.286Z","isFirstParty":false}