# Suverse OSM Reverse Geocoder

> Suverse OSM Reverse Geocoder is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-16).

Converts latitude/longitude coordinates into a human-readable address and place details using OpenStreetMap's Nominatim service

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-places-osm-reverse
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-osm-reverse-geocoder-d4258999
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oOqWVFzYi5Od-qzfZ-tOh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suverse-osm-reverse-geocoder-d4258999 -d '<json body>'
```

Example prompt: What's the street address for the location at latitude 48.8584 and longitude 2.2945? Use the OSM reverse geocoder to get me the full address with city and country.

## When to prefer this

Choose this endpoint when you need free, keyless reverse geocoding backed by OpenStreetMap data without requiring an API key or account. It is ideal for agents that need to convert raw GPS coordinates into human-readable addresses at low cost ($0.06/call), particularly when you want open-data coverage globally and don't need proprietary data from Google Maps or similar paid services.

## Known failure modes

- Coordinates outside any mapped OSM area return empty or sparse results
- Invalid or missing lat/lon values cause a 400 bad request error
- Very remote or oceanic coordinates may return only country-level data
- Nominatim rate limits on the underlying service may cause transient failures
- Coordinates with too many decimal places or wrong format may fail validation

## How this service works

Turn coordinates into an address. Pass lat and lon and get the nearest OpenStreetMap feature with display name, type, and address components. Backed by Nominatim/OSM, free and keyless.

## Output

Returns the nearest OpenStreetMap feature matching the given coordinates, including a full display name (formatted address string), place type (e.g. road, building, suburb), and structured address components such as street, city, state, postcode, and country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-osm-reverse-geocoder-d4258999/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)