# WorldData402 Reverse Geocode

> WorldData402 Reverse Geocode is a paid API for AI agents from worlddata402.worlddata402.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Converts a latitude/longitude coordinate pair into human-readable location data (country, region, city, etc.)

## Facts

- Endpoint: GET https://worlddata402.worlddata402.workers.dev/v1/reverse-geocode?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/worlddata402-reverse-geocode-e4aca437
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_36VHWe9aUOhuyjdqLhrMN

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 worlddata402-reverse-geocode-e4aca437
```

Example prompt: What city and country are at coordinates 48.8566° N, 2.3522° E? Use reverse geocoding to look it up.

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-subscription reverse geocoding service that settles instantly via USDC on Base mainnet through the x402 protocol, making it ideal for AI agents with autonomous crypto payment capabilities. Best suited for sporadic or agent-driven lookups where a monthly SaaS subscription would be wasteful.

## Known failure modes

- Missing required lat or lon parameter returns a 400 error
- Coordinates outside valid range (lat: -90 to 90, lon: -180 to 180) may return an error or empty result
- Payment failure via x402/USDC returns a 402 Payment Required response
- Coordinates in the middle of an ocean or uninhabited area may return sparse or null location fields
- Rate limits or worker errors may return 5xx responses

## How this service works

Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).

## Output

A JSON object containing human-readable location information for the provided coordinates, typically including country, region/state, city, and possibly administrative subdivision details derived from the lat/lon pair.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lon"
 ],
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/worlddata402-reverse-geocode-e4aca437/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from worlddata402.worlddata402.workers.dev](https://www.zero.xyz/host/worlddata402.worlddata402.workers.dev/llms.txt)