# Netzhandwerker Phone Number Parser

> Netzhandwerker Phone Number Parser 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-15).

Parses and normalizes phone numbers from any format into E.164, international, national, and tel-URI representations, with German number type classification (landline, mobile, special rate)

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/phone/parse
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-phone-number-parser-65b9d75e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X3cdg64t5PCRSP0AHBaak

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-phone-number-parser-65b9d75e -d '<json body>'
```

Example prompt: Can you parse the phone number '030 12345678' for me — treat it as a German number — and tell me whether it's a landline or mobile, plus give me the E.164 and international formats?

## When to prefer this

Choose this endpoint when you need reliable, multi-format phone number normalization with specific support for German number type classification (landline vs. mobile vs. special rate with cost hints). It is particularly suited for German-market applications where distinguishing Festnetz, Mobilfunk, and Sonderrufnummern matters. Prefer it over generic phone libraries when you need E.164, international, national, and tel-URI outputs in one call, or when handling national-format German numbers that lack a country prefix.

## Known failure modes

- Unrecognizable number format — returns error if the input cannot be parsed as any valid phone number pattern
- Unknown country prefix — if the number's calling code is not among the 150 supported prefixes, country detection fails
- Ambiguous national number without default_country — numbers without a country prefix may be misclassified if default_country is not set
- Too short or malformed input — very short strings or non-numeric input may return a parse error

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns the parsed phone number in multiple standardized formats: E.164 (e.g. +4930123456), international format (e.g. +49 30 123456), national format (e.g. 030 123456), and tel-URI (e.g. tel:+4930123456). Also returns the detected country calling code, area/network prefix, subscriber number, and for German numbers the number type (Festnetz/landline, Mobilfunk/mobile, or Sonderrufnummer/special) along with any associated cost information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "phone": {
   "type": "string",
   "description": "Rufnummer in beliebiger Schreibweise"
  },
  "default_country": {
   "type": "string",
   "default": "DE",
   "description": "Land fuer Nummern ohne Landeskennzahl"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "e164": "+491701234567",
  "note": "Kein Abgleich gegen Portierungsdatenbanken.",
  "type": "mobil",
  "hints": [
   "Nationale Schreibweise erkannt, mit Landeskennzahl fuer DE ergaenzt."
  ],
  "input": "0170 / 123 45 67",
  "valid": true,
  "country": "DE",
  "area_code": "0170",
  "formatted": {
   "e164": "+491701234567",
   "rfc3966": "tel:+491701234567",
   "national": "00170 1234567",
   "international": "+49 0170 1234567"
  },
  "type_note": null,
  "country_code": "+49",
  "national_number": "1701234567",
  "subscriber_number": "1234567"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-phone-number-parser-65b9d75e/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)