# Halowerk Address Parser & Validator

> Halowerk Address Parser & Validator is a paid API for AI agents from tools.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Parses single-line or multi-line addresses into structured fields (street, house number, suffix, postal code, city, country), validates postal code patterns for 16 countries, and detects P.O. box and automated addresses.

## Facts

- Endpoint: POST https://tools.halowerk.com/v1/address/validate
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-address-parser-validator-a90beddd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Trq-2t4nD9uxbR5JLPHeb

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 halowerk-address-parser-validator-a90beddd -d '<json body>'
```

Example prompt: Can you parse this address and tell me the street, house number, postal code, and city — and check if the postal code is valid? The address is: 'Musterstraße 12a, 10115 Berlin, Deutschland'.

## When to prefer this

Choose this endpoint when you need to parse and validate free-form address text into structured components — especially for German-language or European addresses — with built-in country detection and postal code pattern validation for 16 countries. It handles country-specific street/house number ordering, making it more accurate than generic parsers for European locales. Prefer it over geocoding APIs when you need structured field extraction and format validation rather than geographic coordinates.

## Known failure modes

- Address text is too ambiguous to parse reliably — partial or incomplete addresses may yield missing fields
- Unrecognized country in the address text leads to no postal code pattern validation
- Postal code pattern check only supported for 16 countries — unsupported countries return no pattern validation
- Non-standard formatting or abbreviations may cause incorrect field splitting
- Empty or null address input returns a validation error

## How this service works

Zerlegt eine einzeilige oder mehrzeilige Anschrift in Strasse, Hausnummer, Zusatz, Postleitzahl, Ort und Land, erkennt das Land aus dem Text, prueft das Postleitzahlmuster fuer 16 Laender, beachtet die laenderuebliche Reihenfolge von Strasse und Hausnummer und meldet Postfach- und Automatenadressen.

## Output

A structured JSON object containing separated address components (street, house number, optional suffix, postal code, city, country), the detected country, a postal code validity result against country-specific patterns, and flags indicating whether the address is a P.O. box or automated delivery address.

## 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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-address-parser-validator-a90beddd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.halowerk.com](https://www.zero.xyz/host/tools.halowerk.com/llms.txt)