# Netzhandwerker Geocode

> Netzhandwerker Geocode is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Converts a free-text address to coordinates (forward geocoding) or coordinates to an address (reverse geocoding)

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/geocode
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-geocode-444037f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ek6BwTxKrFrncyAPThI0s

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 netzhandwerker-geocode-444037f4 -d '<json body>'
```

Example prompt: Can you look up the coordinates for 'Unter den Linden 1, Berlin' and limit results to Germany?

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-call geocoding without a subscription, especially for agents operating autonomously via the x402 micropayment protocol. Well-suited for German or European address lookups given the country-scoping parameter.

## Known failure modes

- No results found for the given address or coordinates — returns empty results array
- Invalid latitude/longitude values outside valid range — may return error or empty response
- Country ISO code not recognized — query may return global results or fail
- Ambiguous free-text query with no strong match — returns low-confidence or zero results
- Network or payment authorization failure — HTTP 402 if x402 payment not properly handled

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns one or more geocoded results including place names, formatted addresses, and geographic coordinates corresponding to the input query or lat/lon pair.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "limit": {
   "type": "integer",
   "default": 3,
   "maximum": 10
  },
  "query": {
   "type": "string",
   "description": "Freitext-Adresse für Vorwärtssuche"
  },
  "country": {
   "type": "string",
   "description": "ISO-Code zur Einschränkung, z. B. de"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "forward",
  "results": [
   {
    "lat": 52.2113,
    "lon": 7.0189,
    "city": "",
    "state": "Nordrhein-Westfalen",
    "street": "Achtenbuhr",
    "postcode": "48599",
    "formatted": "Achtenbuhr 12, 48599",
    "confidence": 0.9,
    "country_code": "de",
    "house_number": "12"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-geocode-444037f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)