# Reverse Geocode Coordinates to Street Address (OpenStreetMap + NWS)

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

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

## Facts

- Endpoint: GET https://payai.agentstools.dev/geocode/reverse
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reverse-geocode-coordinates-to-street-address-openstreetmap-nws-53b12d6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xkM10cJlWCNTCXl4Tjd-d

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-street-address-openstreetmap-nws-53b12d6b
```

Example prompt: What's the street address for the coordinates 37.7749° N, 122.4194° W? I also want to know the nearest NWS city if it's in the US.

## When to prefer this

Use this endpoint when you have geographic coordinates and need a human-readable street address or location label, especially when worldwide coverage is required (via OpenStreetMap Nominatim) or when US NWS city context is valuable. Prefer over raw Nominatim calls when you want the NWS enrichment bundled in a single paid API call with no quota management.

## Known failure modes

- Coordinates out of valid range (lat outside [-90,90] or lon outside [-180,180]) returns a validation error
- Remote ocean or uninhabited location may return no address or only a country-level result from Nominatim
- Missing required lat or lon query parameters returns a 400-level error
- NWS enrichment is only available for US points; non-US coordinates will not include NWS city/state
- Nominatim rate limiting or upstream outage may cause timeouts or 5xx errors

## 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 street address string plus parsed address components (house number, road, city, state, country, postcode, etc.) from OpenStreetMap Nominatim. For points within the United States, the response is additionally enriched with the nearest National Weather Service (NWS) city and state designation.

## 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-street-address-openstreetmap-nws-53b12d6b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)