# List Structure Decision

> List Structure 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 evaluates whether a public URL's content lists are structured in a way that meets documented criteria, returning a verdict, evidence, thresholds, and a recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/list-structure-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/list-structure-decision-2b96a8bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tFxtFltHb473UQ2_3k5gp

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 list-structure-decision-2b96a8bd -d '<json body>'
```

Example prompt: Can you check whether the list structure on https://example.com meets agent readiness criteria — I want to know the verdict, what evidence was found, and what action I should take to fix any issues?

## When to prefer this

Use this endpoint when you need a lightweight, passive, evidence-grounded verdict on whether a public URL's list structure meets documented agent readiness criteria. Prefer it over generic SEO audits when the specific concern is structured list compliance for AI consumption, and when you need an actionable recommendation without any intrusive testing or login attempts.

## Known failure modes

- Target URL is unreachable or returns non-200 status — check fails with no evidence
- Target requires authentication — passive check cannot access gated content
- Malformed or non-HTTP(S) URL provided — normalization may fail or return error
- No list structures found on target page — observation returns empty evidence
- Compare URL or baseline mismatch causes inconclusive change detection

## How this service works

List structure 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 decision object containing: the observation made about the target's list structure, the threshold used for evaluation, a pass/fail/conditional verdict, the exact evidence source URL, any limitations of the passive check, and a mode-specific recommended action to address issues found.

## 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/list-structure-decision-2b96a8bd/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)