# Geocoding API (Forward & Reverse)

> Geocoding API (Forward & Reverse) is a paid API for AI agents from api-production-17e1.up.railway.app, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Converts an address or place name to latitude/longitude coordinates (forward geocoding) or converts lat/lon to a structured address (reverse geocoding), billed per-call in USDC via x402.

## Facts

- Endpoint: GET https://api-production-17e1.up.railway.app/geocode
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geocoding-api-forward-reverse-dab031f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X1A0vei3YO2AEvG7sxCt6

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 geocoding-api-forward-reverse-dab031f1
```

Example prompt: What are the latitude and longitude coordinates for 221B Baker Street, London? Also give me the full structured address if you can.

## When to prefer this

Choose this endpoint when you need a pay-per-call geocoding service with no API key or signup required, billed in USDC via x402. Ideal for AI agents needing to resolve addresses to coordinates or coordinates to addresses on demand without pre-negotiated credentials.

## Known failure modes

- Address not found or ambiguous — returns empty result or error
- Invalid lat/lon values out of range — returns validation error
- Payment failure via x402 — call not processed
- Network timeout to Railway-hosted service — transient error
- Non-geocodable input (e.g. free-form text that is not an address) — no result returned

## How this service works

Geocoding for AI agents. Forward: an address/place → latitude, longitude, and full structured address. Reverse: lat/lon → the address at that point. Pay-per-call in USDC via x402 — no signup, no API key. Use to resolve locations, map places, and add coordinates.

## Output

Returns latitude, longitude, and a full structured address object (including street, city, region, country, postal code) for the queried location. For reverse geocoding, returns the address at the given coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The page URL to unfurl."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geocoding-api-forward-reverse-dab031f1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api-production-17e1.up.railway.app](https://www.zero.xyz/host/api-production-17e1.up.railway.app/llms.txt)