# Reverse Geocode Coordinates to Address (OpenStreetMap + NWS)

> Reverse Geocode Coordinates to Address (OpenStreetMap + NWS) is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Converts latitude/longitude coordinates to a full street address with parsed components worldwide, enriched with the nearest NWS city/state for US coordinates.

## Facts

- Endpoint: GET https://api.agentstools.dev/geocode/reverse?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reverse-geocode-coordinates-to-address-openstreetmap-nws-7a58785d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hSiwny6pTiN52q5JhNwhh

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-coordinates-to-address-openstreetmap-nws-7a58785d
```

Example prompt: What's the street address at coordinates 40.7128, -74.0060? Give me the full address with parsed components.

## When to prefer this

Use this endpoint when you have GPS coordinates and need a human-readable address or structured address components — especially useful for US locations where NWS city/state enrichment is needed for weather lookups. Prefer this over forward geocoding when you already have coordinates and need the address, not the other way around. Works worldwide via OpenStreetMap Nominatim.

## Known failure modes

- Coordinates fall in an ocean or unpopulated area with no nearby address in Nominatim — may return partial or empty result
- Latitude out of range [-90, 90] or longitude out of range [-180, 180] — returns validation error
- NWS enrichment unavailable for non-US coordinates — NWS fields omitted but base address still returned
- Nominatim rate limit or upstream timeout — returns 5xx error
- Missing required lat or lon query parameter — returns 400 error

## How this service works

Reverse-geocode coordinates (WORLDWIDE) to a street address + parsed components via OpenStreetMap Nominatim; enriched with the nearest NWS city/state when the point is in the US.

## Output

Returns a full formatted street address along with parsed address components (street number, road, city, county, state, country, postcode, etc.). For US coordinates, also includes the nearest NWS city and state identifiers for weather lookup purposes.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude [-90,90]"
      },
      "lon": {
       "type": "number",
       "description": "Longitude [-180,180]"
      }
     }
    }
   },
   "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/reverse-geocode-coordinates-to-address-openstreetmap-nws-7a58785d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)