{"uid":"cap_cGYxICXhngeMun2ERUZDI","slug":"agent402-tools-reverse-geocode-db1b57cb","name":"agent402.tools Reverse Geocode","description":"Resolve a lat/lon to a structured postal address: road, house number, city, state, postcode, country (with ISO code). OpenStreetMap/Nominatim, no key. ?lat=38.8977&lon=-77.0365.","url":"https://agent402.tools/api/reverse-geocode","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","required":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude, -90 to 90"},"lon":{"type":"number","description":"Longitude, -180 to 180"},"zoom":{"type":"number","description":"Detail level, 3 (country) to 18 (building). Default 18."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["lat","lon","displayName","address","type","class","osm","source"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"osm":{"type":"string"},"type":{"type":"string"},"class":{"type":"string"},"source":{"type":"string"},"address":{"type":"object"},"displayName":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"lat":38.8977,"lon":-77.0365,"osm":"way/238241022","type":"attraction","class":"tourism","source":"nominatim.openstreetmap.org (ODbL)","address":{"city":"Washington","road":"Pennsylvania Avenue Northwest","state":"District of Columbia","country":"United States","postcode":"20500","countryCode":"us","houseNumber":"1600"},"displayName":"White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":40.7128,"lon":-74.006,"zoom":18}}},"response":{"lat":40.7128,"lon":-74.006,"osm":"way/575213527","type":"townhall","class":"amenity","source":"nominatim.openstreetmap.org (ODbL)","address":{"city":"New York","road":"Broadway","state":"New York","county":"New York County","country":"United States","postcode":"10000","countryCode":"us","houseNumber":"260","neighbourhood":"Tribeca"},"displayName":"New York City Hall, 260, Broadway, Tribeca, Lower Manhattan, Manhattan, New York County, New York, 10000, United States"}},"exampleRequest":{"lat":40.7128,"lon":-74.006,"zoom":18},"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_zQByf5aiGH938qHxO2fy2","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":"Converts latitude/longitude coordinates into a structured postal address including road, house number, city, state, postcode, and country using OpenStreetMap/Nominatim — no API key required.","exampleAgentPrompt":"What's the street address at coordinates 38.8977 latitude, -77.0365 longitude?","exampleUseCases":null,"resultDescription":"Returns a structured postal address object with fields including road name, house number, city, state, postcode, country name, and ISO country code corresponding to the provided coordinates.","failureModes":["Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) return a validation error","Coordinates in remote or unmapped areas may return incomplete address fields (missing road or house number)","Ocean or uninhabited coordinates may return only country-level data","Payment failure (x402) returns 402 status before the geocode is attempted","Nominatim upstream outage results in a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to resolve a lat/lon to a structured postal address without managing an API key. It is powered by OpenStreetMap/Nominatim and is ideal for agents that need street-level address enrichment from GPS coordinates, device location data, or coordinate-tagged records. Prefer this over forward geocoding endpoints when you already have coordinates and need a human-readable address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:50:30.484Z","isFirstParty":false}