{"uid":"cap_3QAWRioeO0I9OuuDxd4VG","slug":"td-agent-utility-openapi-specification-validator-5c08bbff","name":"TD Agent Utility · OpenAPI Specification Validator","description":"Independent website and deployment verification for AI agents: HTTP, DNS, TLS and Chromium screenshot evidence. Three deterministic tools, x402 V2 Base USDC.","url":"https://tdagentutility.co.uk/v1/openapi-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"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":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_heD2ZXU4sKWmHSg9TtwSS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an OpenAPI specification URL or document, checking parse validity, operation completeness, schema correctness, and security schemes, returning a scored report.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-publish API spec audit","prompt":"Before I publish my API docs, can you validate my OpenAPI spec at https://api.myapp.com/openapi.yaml and tell me if there are any parse errors, unresolved refs, or operations missing descriptions?"},{"title":"CI pipeline spec quality check","prompt":"Run a validation check on the OpenAPI spec at https://staging.internalapi.io/openapi.json and give me the score, result status, and a list of any ambiguous parameters or duplicate operation IDs I need to fix."},{"title":"Third-party API spec review","prompt":"I'm integrating with a vendor API — can you validate their OpenAPI spec at https://vendor.example.com/api-docs and tell me if it's well-formed, what version it is, and flag any security scheme issues or malformed schemas?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:41:23.398Z","isFirstParty":false,"canonicalSlug":"td-agent-utility-openapi-specification-validator-5c08bbff"}