# Canonical Identity Decision

> Canonical Identity Decision is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively inspects a public URL or domain for canonical identity signals and returns a structured verdict with evidence, threshold, limitations, and a recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/canonical-identity-decision?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/canonical-identity-decision-c2add9df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MaT7NiQfIWFeitl8wyscg

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 canonical-identity-decision-c2add9df -d '<json body>'
```

Example prompt: Can you passively check whether https://example.com has its canonical identity properly configured and give me a verdict with the evidence source and any limitations?

## When to prefer this

Choose this endpoint when you need a passive, read-only evaluation of canonical identity signals on a public web property without performing any active exploit, login, or form submission. Prefer it over generic SEO audit tools when you need a structured machine-readable verdict with explicit evidence sourcing and documented limitations, especially in agentic workflows that require traceable decisions.

## Known failure modes

- Target URL unreachable or returns non-200 status — endpoint cannot fetch evidence
- Malformed or non-public URL provided — normalization fails
- Target blocks crawlers — observation may be incomplete or absent
- Baseline mismatch if a stale baseline is supplied — comparison may be inaccurate
- Rate limits or payment failures via x402 protocol — call not processed

## How this service works

Canonical identity decision fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns a structured object containing: the observation (what was found on the target), the threshold used for evaluation, a pass/fail verdict, the exact evidence source URL, limitations of the passive check, and a mode-specific recommended action. No login, injection, exploit, purchase, or load test is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/canonical-identity-decision-c2add9df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)