# Netzhandwerker Address Validation

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

Parses, normalizes, and validates postal addresses (format check and completeness scoring, no official registry lookup)

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/address/validate
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-address-validation-511daa2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Je-9vcf-vW42XuFLJfW4V

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-address-validation-511daa2d -d '<json body>'
```

Example prompt: Can you validate and normalize this address: Hauptstraße 12a, 48599 Gronau, Germany — check if it's correctly formatted and give me the parsed components?

## When to prefer this

Choose this endpoint when you need lightweight, fast address format validation and normalization without requiring a connection to an official address registry. It is ideal for pre-validating user input in forms, normalizing free-text addresses into structured components, or checking address completeness before storage — especially for German and European addresses. It is not suitable when you need to verify that a street actually exists (registry lookup) or when geocoding coordinates are required.

## Known failure modes

- Unrecognizable address format — parser cannot split components, may return low completeness or issues
- Unsupported country — country code or name not recognized, validation may be incomplete
- Missing required fields — if neither 'address' nor individual fields are provided, validation cannot proceed
- Ambiguous street/house number split — may be parsed incorrectly if format is unusual
- Network or payment failure — x402 micropayment not processed, request rejected

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object with: a boolean 'valid' field, a 'completeness' percentage (0–100), a 'parsed' object with individual address components (street, house_number, city, postal_code, addition), a 'formatted' array of address lines, a 'formatted_single_line' string, the ISO 'country' code, 'country_name', plus 'issues' and 'hints' arrays for any detected problems, and a 'note' clarifying that this is a format check only, not a registry lookup.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string"
  },
  "street": {
   "type": "string"
  },
  "address": {
   "type": "string",
   "description": "Vollstaendige Anschrift, Zeilen oder Kommas als Trenner"
  },
  "country": {
   "type": "string",
   "description": "ISO-Code oder Landesname"
  },
  "addition": {
   "type": "string"
  },
  "postal_code": {
   "type": "string"
  },
  "house_number": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Formatpruefung und Normalisierung. Kein Abgleich gegen ein amtliches Strassenverzeichnis.",
  "hints": [],
  "valid": true,
  "issues": [],
  "parsed": {
   "city": "Gronau",
   "street": "Hauptstraße",
   "addition": null,
   "postal_code": "48599",
   "house_number": "12a"
  },
  "country": "DE",
  "formatted": [
   "Hauptstraße 12a",
   "48599 Gronau",
   "Deutschland"
  ],
  "completeness": 100,
  "country_name": "Deutschland",
  "formatted_single_line": "Hauptstraße 12a, 48599 Gronau, Deutschland"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-address-validation-511daa2d/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)