# Halowerk Phone Number Parser

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

Parses and normalizes phone numbers from any notation, detects country codes from 150 prefixes, splits into area code and subscriber number, and returns E.164, international, national, and tel-URI formats with German line-type classification.

## Facts

- Endpoint: POST https://tools.halowerk.com/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/halowerk-phone-number-parser-704887c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_34tMI1XxdxtUnQYtMSY5t

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

Example prompt: Can you parse the phone number '089 12345678' — assume it's German if no country code is given — and give me the E.164 format, the tel-URI, and whether it's a landline, mobile, or special number?

## When to prefer this

Choose this endpoint when you need to parse, normalize, or classify phone numbers across 150 country prefixes, especially when input may arrive in any national or international notation. It is particularly valuable for German phone numbers where line-type classification (landline, mobile, special/premium) and cost hints are needed. Prefer it over generic regex-based parsing when you need reliable E.164 output, tel-URI generation, and structured decomposition into area code and subscriber number.

## Known failure modes

- Unrecognized country prefix — number does not match any of the 150 supported country codes
- Ambiguous national number without a default country specified — cannot determine country
- Malformed or too-short number string — cannot parse into valid components
- Special number type unrecognized for non-German numbers — line-type classification only available for Germany

## How this service works

Nimmt jede Schreibweise, erkennt die Landeskennzahl aus 150 Vorwahlen, ergaenzt bei nationaler Schreibweise das Standardland, zerlegt in Vorwahl und Teilnehmernummer und bestimmt fuer Deutschland Festnetz, Mobilfunk und Sonderrufnummern mit Kostenhinweis. Liefert E.164, internationale und nationale Schreibweise sowie tel-URI.

## Output

Returns a structured object containing the normalized phone number in E.164, international, and national formats, the tel-URI, the detected country code, the separated area code and subscriber number, and for German numbers a classification of the line type (landline, mobile, or special/premium rate) along with any applicable cost hints.

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

## More

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