{"uid":"cap_XK5jELSBVlMiliXN7S-TU","slug":"x402-farm-reverse-geocoding-ban-nominatim-0612cdc4","name":"x402-farm Reverse Geocoding (BAN/Nominatim)","description":"Turn coordinates into the nearest postal address: BAN in France, OpenStreetMap elsewhere. Coordinates to the nearest address: BAN in France (with INSEE code), Nominatim elsewhere. Query: ?lat=48.8698&lon=2.3310","url":"https://api.x-402.online/v1/geo/reverse?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_C3U0xYnaCoRjMcZTmUMEg","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 latitude/longitude coordinates into the nearest postal address using BAN for France (with INSEE code) and Nominatim/OpenStreetMap elsewhere.","exampleAgentPrompt":"What's the postal address at coordinates 48.8698 latitude and 2.3310 longitude — give me the full street address including postcode.","exampleUseCases":[{"title":"Identify delivery drop-off address","prompt":"I have a GPS coordinate from a delivery driver's app — lat 48.8698, lon 2.3310 — can you tell me the actual street address so I can verify the drop-off location?"},{"title":"Annotate photo location with address","prompt":"A photo was tagged at coordinates 51.5074 latitude and -0.1278 longitude — what's the nearest postal address there so I can label the image properly?"},{"title":"Field survey location logging","prompt":"We recorded a site inspection at lat 43.2965, lon 5.3698 in France — can you get the official address including the INSEE code for our records?"}],"resultDescription":"A structured address object including street number, street name, city/municipality, postcode, and country. For French coordinates, also includes the INSEE commune code sourced from the Base Adresse Nationale (BAN). For all other locations, address data comes from Nominatim/OpenStreetMap.","failureModes":["Coordinates in the middle of the ocean or uninhabited areas may return no address or a low-confidence nearest match","Missing or malformed lat/lon query parameters will return a 400 error","Coordinates outside supported regions may return incomplete address data from Nominatim","Payment failure or insufficient USDC balance will return a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need pay-per-call reverse geocoding with no account or subscription required, especially for French addresses where BAN data provides authoritative INSEE codes. Ideal for AI agents using the x402 protocol on Base with USDC microtransactions, where per-call billing is preferred over monthly API plans. Best for lightweight, sporadic lookups rather than bulk batch geocoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:30:03.974Z","isFirstParty":false,"canonicalSlug":"x402-farm-reverse-geocoding-ban-nominatim-0612cdc4"}