# Reverse Geocode (agentutility x402)

> Reverse Geocode (agentutility x402) is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-01).

Converts a latitude/longitude coordinate pair into a structured address and place details using OpenStreetMap Nominatim

## Facts

- Endpoint: POST https://x402.agentutility.ai/reverse-geocode?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reverse-geocode-agentutility-x402-13a43834
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wr3ScvkwXAXhL2Kaq01Qx

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 reverse-geocode-agentutility-x402-13a43834 -d '<json body>'
```

Example prompt: What's the street address at coordinates 37.422, -122.085? I need the full address including road, city, state, and postcode.

## When to prefer this

Use this endpoint when you have a GPS coordinate pair and need a human-readable address or structured location metadata without setting up a Google Maps or HERE API account. It is pay-per-call with no signup, making it ideal for occasional or agent-driven reverse geocoding tasks. Prefer it over forward geocoding endpoints when you already have coordinates and need place details. The zoom parameter makes it flexible for coarse (country/state) or fine (street/building) resolution.

## Known failure modes

- Coordinates out of range (-90 to 90 for latitude, -180 to 180 for longitude) will result in an error
- Remote ocean or uninhabited areas may return no meaningful address, only country-level data
- Missing required latitude or longitude fields returns a validation error
- Very high zoom levels in sparse areas may fall back to coarser resolution results
- x402 payment failure or insufficient USDC balance blocks the call

## How this service works

817 pay-per-call APIs for AI agents. Every endpoint is POST /<name> and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON.

## Output

A JSON object containing the resolved address broken into structured fields (road, city, county, state, country, postcode, country_code), plus a full display_name string, place type, OSM ID, place_id, importance score, zoom level, and a bounding box array for the resolved place. The source attribution to OpenStreetMap Nominatim is included.

## 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": {
     "required": [
      "latitude",
      "longitude"
     ],
     "properties": {
      "zoom": {
       "type": "number",
       "description": "Address detail level. 3 (country) → 5 (state) → 10 (city) → 13 (village) → 17 (street, default) → 18 (building)."
      },
      "latitude": {
       "type": "number",
       "description": "Latitude in decimal degrees. Range -90 to 90."
      },
      "longitude": {
       "type": "number",
       "description": "Longitude in decimal degrees. Range -180 to 180."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "type": {
       "type": "string"
      },
      "zoom": {
       "type": "integer"
      },
      "osm_id": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "address": {
       "type": "object",
       "properties": {
        "city": {
         "type": "string"
        },
        "road": {
         "type": "string"
        },
        "state": {
         "type": "string"
        },
        "county": {
         "type": "string"
        },
        "country": {
         "type": "string"
        },
        "postcode": {
         "type": "string"
        },
        "country_code": {
         "type": "string"
        }
       }
      },
      "latitude": {
       "type": "number"
      },
      "place_id": {
       "type": "integer"
      },
      "longitude": {
       "type": "number"
      },
      "importance": {
       "type": "number"
      },
      "bounding_box": {
       "type": "array",
       "items": {
        "type": "number"
       }
      },
      "display_name": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Charleston Road",
  "type": "secondary",
  "zoom": 17,
  "osm_id": 12345678,
  "source": "OpenStreetMap Nominatim (ODbL, attribution required)",
  "address": {
   "city": "Mountain View",
   "road": "Charleston Road",
   "state": "California",
   "county": "Santa Clara County",
   "country": "United States",
   "postcode": "94043",
   "country_code": "us"
  },
  "latitude": 37.422,
  "place_id": 87654321,
  "longitude": -122.085,
  "importance": 0.0534,
  "bounding_box": [
   37.4209778,
   37.421024,
   -122.0853216,
   -122.0846815
  ],
  "display_name": "Charleston Road, Mountain View, Santa Clara County, California, 94043, United States"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reverse-geocode-agentutility-x402-13a43834/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)