# Halowerk PII Redact

> Halowerk PII Redact 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-13).

Detects and redacts personally identifiable information (PII) — including email, phone, IBAN, credit card, IP address, tax ID, VAT number, license plate, social security number, and birth date — from text, returning per-match category, position metadata, and three redaction variants without storing the found values.

## Facts

- Endpoint: POST https://tools.halowerk.com/v1/pii/redact
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-pii-redact-5fd0ab16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_icmCfLBBT4tkBj7MaHNck

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-pii-redact-5fd0ab16 -d '<json body>'
```

Example prompt: Can you scan this customer support message for any personal data like emails, phone numbers, IBANs, or social security numbers, and give me a redacted version? Here's the text: 'Please contact me at hans.mueller@example.de or call 0170-1234567, my IBAN is DE44500105175407324931.'

## When to prefer this

Choose this endpoint when you need structured, per-match position metadata alongside redacted output and multiple redaction styles, especially for European PII formats (IBAN with checksum, German tax IDs, EU VAT, Sozialversicherungsnummer, Kennzeichen). It is ideal for GDPR compliance pipelines, pre-storage anonymization, or audit trails where knowing exactly where PII occurred (line, column, position) matters. Prefer it over regex-based solutions because it applies checksum validation (Luhn for credit cards, mod 97 for IBAN) to reduce false positives.

## Known failure modes

- Text contains no detectable PII — returns empty match list
- Malformed or non-text input — may return validation error
- Ambiguous patterns that resemble PII but fail checksum validation (e.g. invalid Luhn) are not flagged
- Very long texts may increase latency
- Non-German/non-European formats may have lower detection coverage for some entity types like VAT or SSN

## How this service works

Findet E-Mail, Telefon, IBAN mit Pruefsumme, Kreditkarte mit Luhn-Pruefung, IP-Adressen, Steuer- und Umsatzsteuernummern, Kennzeichen, Sozialversicherungsnummern und Geburtsdaten mit Kontextwort. Liefert je Treffer Kategorie, Zeile, Spalte und Position sowie den geschwaerzten Text in drei Schwaerzungsarten. Die Fundwerte werden nicht gespeichert.

## Output

For each PII match found: the category (e.g. EMAIL, PHONE, IBAN, CREDIT_CARD, IP, TAX_ID, VAT, LICENSE_PLATE, SSN, BIRTHDATE), the line number, column number, and character position within the text, and the full text with three redaction variants applied. The found values themselves are not stored or logged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "mask",
    "label",
    "hash"
   ],
   "type": "string",
   "default": "mask",
   "description": "mask ersetzt teilweise, label setzt Platzhalter, hash setzt eine stabile Kennung"
  },
  "text": {
   "type": "string",
   "description": "Zu pruefender Text"
  },
  "reveal": {
   "type": "boolean",
   "default": false,
   "description": "Fundwerte im Klartext zurueckgeben"
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Nur diese Kategorien pruefen"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-pii-redact-5fd0ab16/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)