# Unicode 17 Canonical & Compatibility Normalization Conformance

> Unicode 17 Canonical & Compatibility Normalization Conformance is a paid API for AI agents from detect.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-17).

Reconstructs all four Unicode normalization forms (NFC, NFD, NFKC, NFKD) for a given string and reports whether the input is already normalized in each form, enabling canonical identity comparison.

## Facts

- Endpoint: POST https://detect.halowerk.com/v1/F-TD2000-DOCUMENTS-06/unicode17-canonical-compatibility-normalization-conformance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/unicode-17-canonical-compatibility-normalization-conformance-c9429f41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5iuBERnqIBi-kP0vHBFaW

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 unicode-17-canonical-compatibility-normalization-conformance-c9429f41 -d '<json body>'
```

Example prompt: Can you normalize the string 'café' into all four Unicode forms — NFC, NFD, NFKC, and NFKD — and tell me which forms it's already normalized in?

## When to prefer this

Choose this endpoint when you need authoritative reconstruction of all four Unicode normalization forms simultaneously and need conformance-level assurance (Unicode 17). Prefer it over client-side normalization libraries when you need a canonical, versioned, server-verified result for identity comparison, deduplication, or conformance testing — especially in multi-language pipelines where local library versions may differ.

## Known failure modes

- Input text exceeds 2000 character limit — rejected with validation error
- Malformed JSON artifact structure — returns schema validation error
- Empty string input — returns normalized forms identical to input with all already_normalized flags true
- Network timeout on unusually complex strings with many combining characters
- Payment of 0.003 USDC not received — 402 Payment Required response

## How this service works

Reconstruct all four Unicode normalization forms for a supplied string before canonical identity comparison.

## Output

Returns all four Unicode normalization forms (NFC, NFD, NFKC, NFKD) of the supplied string, boolean flags indicating whether the original string was already normalized in each form, and the Unicode version used for normalization.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "artifact": {
   "type": "object",
   "required": [
    "unicodeNormalization"
   ],
   "properties": {
    "unicodeNormalization": {
     "type": "object",
     "required": [
      "data",
      "claim"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "text"
       ],
       "properties": {
        "text": {
         "type": "string",
         "maxLength": 2000,
         "minLength": 0
        }
       },
       "additionalProperties": false
      },
      "claim": {
       "anyOf": [
        {
         "type": "null"
        },
        {
         "type": "object",
         "required": [
          "unicode_version",
          "forms",
          "already_normalized"
         ],
         "properties": {
          "forms": {
           "type": "object",
           "required": [
            "NFC",
            "NFD",
            "NFKC",
            "NFKD"
           ],
           "properties": {
            "NFC": {
             "type": "string",
             "maxLength": 20000,
             "minLength": 0
            },
            "NFD": {
             "type": "string",
             "maxLength": 20000,
             "minLength": 0
            },
            "NFKC": {
             "type": "string",
             "maxLength": 20000,
             "minLength": 0
            },
            "NFKD": {
             "type": "string",
             "maxLength": 20000,
             "minLength": 0
            }
           },
           "additionalProperties": false
          },
          "unicode_version": {
           "type": "string",
           "maxLength": 16,
           "minLength": 1
          },
          "already_normalized": {
           "type": "object",
           "required": [
            "NFC",
            "NFD",
            "NFKC",
            "NFKD"
           ],
           "properties": {
            "NFC": {
             "type": "boolean"
            },
            "NFD": {
             "type": "boolean"
            },
            "NFKC": {
             "type": "boolean"
            },
            "NFKD": {
             "type": "boolean"
            }
           },
           "additionalProperties": false
          }
         },
         "additionalProperties": false
        }
       ]
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/unicode-17-canonical-compatibility-normalization-conformance-c9429f41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from detect.halowerk.com](https://www.zero.xyz/host/detect.halowerk.com/llms.txt)
