# TD Agent Utility · OpenAPI Specification Validator

> TD Agent Utility · OpenAPI Specification Validator is a paid API for AI agents from tdagentutility.co.uk, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

Validates an OpenAPI specification URL or document, checking parse validity, operation completeness, schema correctness, and security schemes, returning a scored report.

## Facts

- Endpoint: POST https://tdagentutility.co.uk/v1/openapi-check?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/td-agent-utility-openapi-specification-validator-5c08bbff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3QAWRioeO0I9OuuDxd4VG

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 td-agent-utility-openapi-specification-validator-5c08bbff -d '<json body>'
```

Example prompt: Can you check my OpenAPI spec at https://api.myservice.com/openapi.json and tell me if it's valid — list any errors, warnings, missing operation IDs, and give me an overall score?

## When to prefer this

Choose this endpoint when you need a deterministic, scored audit of an OpenAPI specification document — especially when you want structured output listing specific categories of issues (unresolved refs, missing operation IDs, ambiguous parameters, duplicate IDs, undescribed operations) rather than just a binary valid/invalid check. It is particularly useful in CI/CD pipelines, pre-publish reviews, or when evaluating third-party API specs for integration readiness.

## Known failure modes

- Spec URL unreachable or returns non-200 — errors array populated, parse_valid false
- Document is not valid YAML or JSON — parse_valid false, errors list parse failure
- Circular/recursive references detected — recursive_refs array populated
- Network timeout fetching remote spec — result_status FAIL with timeout error
- Empty or null input — returns score 0, valid false with appropriate error

## How this service works

Independent website and deployment verification for AI agents: HTTP, DNS, TLS and Chromium screenshot evidence. Three deterministic tools, x402 V2 Base USDC.

## Output

Returns a JSON object with a numeric quality score (0–100), a boolean parse_valid flag, a result_status string (e.g. PASS/FAIL), arrays of errors, warnings, recursive_refs, unresolved_refs, malformed_schemas, ambiguous_parameters, missing_operation_ids, undescribed_operations, and duplicate_operation_ids, plus a list of servers, security_schemes, operations, the detected openapi_version, operation_count, a summary string, and a checked_at timestamp.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "openapi_check",
  "score": 0,
  "valid": false,
  "errors": [],
  "servers": [],
  "summary": "",
  "warnings": [],
  "checked_at": "2026-10-15T00:00:00Z",
  "operations": [],
  "parse_valid": false,
  "result_status": "PASS",
  "recursive_refs": [],
  "openapi_version": null,
  "operation_count": 0,
  "unresolved_refs": [],
  "security_schemes": {},
  "malformed_schemas": [],
  "ambiguous_parameters": [],
  "missing_operation_ids": [],
  "undescribed_operations": [],
  "duplicate_operation_ids": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/td-agent-utility-openapi-specification-validator-5c08bbff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tdagentutility.co.uk](https://www.zero.xyz/host/tdagentutility.co.uk/llms.txt)