# Netzhandwerker PII Redaction

> Netzhandwerker PII Redaction 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-13).

Detects and redacts personally identifiable information (PII) such as emails, IBANs, and phone numbers from text using masking, labeling, or hashing modes.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/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/netzhandwerker-pii-redaction-9c73abde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DgcEhDqr1B0x7wxkkto2S

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-pii-redaction-9c73abde -d '<json body>'
```

Example prompt: Scan this text and mask any PII you find — emails, IBANs, and phone numbers — using partial masking mode: 'Please send to anna.mueller@example.com, IBAN DE89 3704 0044 0532 0130 00, Tel +49 30 1234567.'

## When to prefer this

Choose this endpoint when you need fast, per-call PII redaction on arbitrary text strings with flexible output modes (mask, label, hash) and category filtering. It is well-suited for preprocessing user input, sanitizing logs, or anonymizing text before storage or AI processing. Prefer it over full NLP-based PII pipelines when deterministic pattern matching for structured PII types (emails, IBANs, phone numbers) is sufficient and low latency matters.

## Known failure modes

- Empty or missing text field returns an error or empty findings
- Unknown category strings in the categories array may be silently ignored or cause a 400 error
- Very long texts may time out or hit payload limits
- Pattern-based detection may produce false positives for email-like or IBAN-like strings
- False negatives are possible since detection is regex/pattern-based, not NLP name recognition
- Invalid mode enum value returns a 400 validation error

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object containing the redacted version of the input text, a list of findings with character positions, line/column numbers, preview snippets, and category labels, plus a by_category count summary and the redaction mode used. Optionally includes the original found values if reveal=true.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "mask",
  "note": "Mustererkennung, kein Namensverzeichnis.",
  "findings": [
   {
    "end": 37,
    "line": 1,
    "start": 13,
    "column": 14,
    "preview": "a**********@example.com",
    "category": "email"
   },
   {
    "end": 73,
    "line": 1,
    "start": 51,
    "column": 52,
    "preview": "******************3000",
    "category": "iban"
   }
  ],
  "by_category": {
   "iban": 1,
   "email": 1,
   "phone": 1
  },
  "redacted_text": "Bitte an a**********@example.com senden, IBAN ******************3000, Tel ********567.",
  "findings_count": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-pii-redaction-9c73abde/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)