# x402-farm Reverse Geocode

> x402-farm Reverse Geocode is a paid API for AI agents from x402-farm.vercel.app, paid per call via x402, $0.005/call, status down (last checked 2026-09-15).

Converts geographic coordinates (latitude/longitude) into a human-readable location label including city name and postal code, paid per-call via x402/USDC.

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/reverse-geocode
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-farm-reverse-geocode-f4510220
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_StHxOTUrXYKfL4uHwbKGF

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 x402-farm-reverse-geocode-f4510220
```

Example prompt: What city and postal code corresponds to the coordinates 16.24° N, 61.53° W?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call reverse geocoding lookup without signing up for an account or managing API keys — ideal for AI agents making occasional or bursty geocoding calls that pay per use in USDC via the x402 protocol. Prefer this over subscription-based geocoding APIs when you want zero-commitment usage and the x402 micropayment flow is already integrated into your agent runtime.

## Known failure modes

- Missing or invalid query parameters (lat/lon not provided) — likely returns a 400 or error JSON
- Coordinates outside supported geographic coverage — may return empty or null fields
- Payment not fulfilled via x402 — returns HTTP 402 Payment Required
- Network timeout or cold-start on serverless deployment — request times out

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

A JSON object containing the postal code (cp), city label (label), and city name (ville) corresponding to the queried coordinates. Example: {"cp": "97110", "label": "Pointe-à-Pitre", "ville": "Pointe-à-Pitre"}.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cp": "97110",
  "label": "Pointe-à-Pitre",
  "ville": "Pointe-à-Pitre"
 }
}
```

## More

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