{"uid":"cap_2B0vXC-Yr0IkppFWdmrN7","slug":"2s-io-2f8f7683","name":"2s.io Reverse Geocoding","description":"Reverse geocoding — latitude/longitude → nearest formatted address plus structured components (houseNumber, road, suburb, city, county, state, postcode, country, countryCode). Query: lat (-90..90), lon (-180..180). Underlying data is OpenStreetMap (ODbL). Sister: /api/geocode/address.","url":"https://2s.io/api/geocode/reverse","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":40.7128,"lon":-74.006}}},"response":{"data":{"ok":true,"meta":{"query":{"kind":"reverse","input":"40.7128,-74.0060"},"cacheHit":true},"items":[{"type":"","class":"","address":{"city":"New York","road":"Broadway","state":"New York","county":"New York County","suburb":"Manhattan","country":"United States of America","postcode":"10007","countryCode":"us","houseNumber":"260"},"latitude":40.712641,"longitude":-74.006087,"importance":0.2,"boundingBox":[40.712641,40.712641,-74.006087,-74.006087],"formattedAddress":"260, Broadway, Civic Center, Manhattan, New York, New York County, New York, 10007, USA"}],"total":1,"source":{"url":"https://www.openstreetmap.org/copyright","license":"LocationIQ terms (attribution required)","provider":"OpenStreetMap contributors"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"geocode.reverse","settlement":{"txHash":"0xea8e419fede881afbb643b5a0cf1fe87f27679f8c73f1c88c5240d92deab3e3e","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":40.7128,"lon":-74.006},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eTF5RxCZExjHOF3ryQDmq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a latitude/longitude coordinate pair into a nearest formatted street address with structured address components, powered by OpenStreetMap data.","exampleAgentPrompt":"What's the nearest street address for the coordinates 40.7128, -74.0060? I need the full address broken down into house number, road, city, state, and zip code.","exampleUseCases":null,"resultDescription":"Returns the nearest formatted street address plus structured components including houseNumber, road, suburb, city, county, state, postcode, country, and countryCode for the given latitude/longitude coordinate.","failureModes":["Coordinates out of range (-90..90 for lat, -180..180 for lon) return a 400 error","Remote or ocean coordinates may return no address if no OSM data exists nearby","Missing required lat or lon parameter returns a 400 validation error","Payment not provided or insufficient returns a 402 Payment Required","OpenStreetMap data may be outdated or incomplete for rural/newly developed areas"],"whenToPreferThis":"Use this endpoint when you need to convert raw GPS or map coordinates into a human-readable address or structured postal components. Ideal for enriching location data in pipelines, labeling map pins, or resolving device GPS output into actionable addresses. Prefer over forward geocoding when you already have coordinates and need the address, not vice versa.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:55:41.466Z","isFirstParty":false}