# FAQ Entity Decision

> FAQ Entity 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 fetches public evidence from a target URL and evaluates whether it satisfies a documented FAQ-entity criterion, returning a verdict, observation, threshold, evidence source, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/faq-entity-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/faq-entity-decision-00bb76f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dW8t7Bhrfqu92ewBR-DaL

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 faq-entity-decision-00bb76f7 -d '<json body>'
```

Example prompt: Check whether https://example.com has properly structured FAQ entities — I need a verdict on whether it meets the threshold, what evidence was found, and any recommended action.

## When to prefer this

Use this endpoint when you need a fast, passive, read-only verdict on whether a specific public URL or domain has structured FAQ entity markup meeting a defined criterion. Prefer it over generic SEO tools when you specifically need an agent-oriented readiness signal with a structured verdict and actionable recommendation, and when you do not want to risk any active testing, login attempts, or form submissions on the target.

## Known failure modes

- Target URL is unreachable or returns a non-200 status — check may fail or return inconclusive verdict
- Target is behind a login or paywall — passive check cannot access private content
- Malformed or non-HTTP(S) URL provided — normalization may fail
- FAQ markup exists but is dynamically injected via JavaScript that passive fetch cannot render
- Rate limiting or bot-blocking by target server prevents evidence retrieval

## How this service works

FAQ entity 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 response containing: the observed evidence found on the target (or its absence), the criterion threshold being evaluated, a pass/fail verdict, the exact source URL of the evidence, any limitations of the passive check, and a mode-specific recommended action. No authentication, form submission, or active testing 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/faq-entity-decision-00bb76f7/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)
