# OpenVerbs Reverse Geocoding API

> OpenVerbs Reverse Geocoding API is a paid API for AI agents from geocode.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Converts latitude/longitude coordinates into the nearest structured postal address, with optional language preference for the result.

## Facts

- Endpoint: POST https://geocode.openverbs.com/v1/reverse
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-reverse-geocoding-api-0e184e08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HGfNMRlJs0JIlloiIpO73

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 openverbs-reverse-geocoding-api-0e184e08 -d '<json body>'
```

Example prompt: What's the street address at coordinates 48.8584° N, 2.2945° E? Give me the result in French if possible.

## When to prefer this

Choose this endpoint when you have raw GPS or decimal-degree coordinates and need a human-readable postal address. It is ideal for enriching location logs, tagging sensor data, resolving delivery coordinates, or displaying user-friendly addresses in apps. It supports a language preference parameter, making it suitable for multilingual applications. Prefer it over forward geocoding when your input is already geographic coordinates rather than a text query.

## Known failure modes

- Coordinates out of valid range (-90 to 90 lat, -180 to 180 lon) result in a validation error
- No nearby address found for coordinates in remote or unpopulated areas
- Invalid 2-letter language code returns an error or falls back to default language
- Network timeout or service unavailability returns a 5xx error
- Payment failure via x402 protocol prevents the call from completing

## How this service works

Convert latitude/longitude coordinates into the nearest structured address. Optionally set the preferred result language.

## Output

A structured address object representing the nearest postal address to the given coordinates, including fields such as street name, house number, city, region, postal code, and country, localized in the requested language if specified.

## 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": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90,
       "description": "Latitude in decimal degrees."
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180,
       "description": "Longitude in decimal degrees."
      },
      "lang": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Preferred result language (2-letter code)."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-reverse-geocoding-api-0e184e08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geocode.openverbs.com](https://www.zero.xyz/host/geocode.openverbs.com/llms.txt)