# Canonical Identity Audit

> Canonical Identity Audit 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 fetches public evidence from a target URL or domain and evaluates its canonical identity signals, returning an observation, verdict, evidence source, limitations, and a recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/canonical-identity-audit?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-audit-e4d587cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ixg_u5AgL37T4cUqsNaeY

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-audit-e4d587cb -d '<json body>'
```

Example prompt: Can you run a passive canonical identity audit on example.com and tell me the verdict, what evidence was found, and what action I should take?

## When to prefer this

Choose this endpoint when you need a passive, read-only audit of a specific domain or URL's canonical identity configuration — especially as part of an agent-readiness pipeline or pre-launch compliance check. Prefer this over general SEO tools when you need a structured verdict with evidence provenance and an actionable recommendation specifically tuned for AI agent discoverability standards.

## Known failure modes

- Target URL is unreachable or returns a non-200 status, resulting in no evidence being gathered
- Target domain does not expose public canonical identity signals, leading to an inconclusive verdict
- Malformed or too-short target input rejected with a validation error
- Rate limiting or upstream network timeouts causing the audit to fail
- Baseline object provided does not match expected format, causing comparison to be skipped

## How this service works

Canonical identity audit 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 result containing the observed canonical identity evidence from the target, the evaluated threshold, a pass/fail verdict, the exact evidence source URL, any limitations of the passive check, and a mode-specific recommended action. No authentication, form submission, or active exploitation 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-audit-e4d587cb/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)
