{"uid":"cap_pORGG-bftcNMHne7tscw0","slug":"latitude-10-api-readiness-report-bafdbdce","name":"Latitude 10 API Readiness Report","description":"How well AI agents will use your API, from its OpenAPI 3.0/3.1 spec: a 0-100 score over 13 rules (operationIds, summaries, descriptions, parameters, enums, examples, JSON bodies, response and error schemas, pagination, auth, idempotency, tool count), every finding, and a suggested fix per operation. POST {\"url\": \"https://…/openapi.json\"} or {\"spec\": \"<JSON or YAML>\"}.","url":"https://latitude10.tech/api/readiness/report?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"https URL of the OpenAPI 3.0 or 3.1 document (JSON or YAML, up to 2 MB)."},"spec":{"type":["string","object"],"description":"The OpenAPI document itself, as JSON or YAML text or as an object. Send url or spec, not both."}}},"responseSchema":{"type":"json","example":{"api":{"title":"Orders API","openapi":"3.1.0","version":"1.0.0"},"rules":[{"id":"descriptions","fix":"…","title":"Descriptions say what the operation does, when to use it, and what it returns","weight":10,"passing":0,"applicable":5}],"score":54,"report":"agent-readiness-report","source":"https://api.example.com/openapi.json","payment":{"network":"eip155:8453","transaction":"0x…"},"verdict":"Agents will struggle with this API as it is.","findings":[{"rule":"descriptions","where":"GET /orders","message":"no description"}],"operations":5,"suggestions":[{"tool":"listOrders","fields":["description"],"operation":"GET /orders","description":"Lists orders, filtered and paged with status, limit, cursor. …"}],"findingsTotal":31}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WPhg7sXaRGB90ta6BVyV-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores an OpenAPI 3.0/3.1 spec for AI-agent usability across 13 rules and returns a 0-100 readiness score, per-rule findings, and suggested fixes per operation.","exampleAgentPrompt":"Can you run an agent-readiness audit on my OpenAPI spec at https://api.myapp.com/openapi.json and tell me the score and what I need to fix?","exampleUseCases":[{"title":"Pre-launch API readiness check","prompt":"Before we publish this API, can you score our OpenAPI spec at https://api.acme.com/openapi.json for AI agent usability and list every rule that's failing?"},{"title":"Fixing agent-unfriendly spec issues","prompt":"Here's our OpenAPI YAML — can you tell me which operations are missing descriptions, examples, or proper error schemas, and give me suggested fixes for each one?"},{"title":"Comparing API quality across versions","prompt":"We just updated our API to v2 — can you run the agent-readiness report on https://api.myservice.com/v2/openapi.json and tell me if the score improved and what's still broken?"}],"resultDescription":"Returns a JSON object containing: a 0-100 agent-readiness score, a verdict sentence, the number of operations analyzed, an array of rule results (id, title, weight, passing count, applicable count, fix suggestion), an array of per-operation findings (rule, operation path, message), and an array of per-operation improvement suggestions with specific field-level recommendations.","failureModes":["URL not reachable or returns non-200 — spec cannot be fetched","Document exceeds 2 MB size limit — truncation or rejection","Invalid or non-OpenAPI JSON/YAML submitted — parse error returned","Neither url nor spec provided — request rejected","Both url and spec provided — ambiguous input error","Payment of 0.1 USDC not sent or rejected by x402 facilitator — 402 response"],"whenToPreferThis":"Use this endpoint when you need a structured, rule-by-rule audit of an OpenAPI spec's fitness for AI agent consumption — specifically covering operationIds, summaries, descriptions, parameters, enums, examples, response schemas, error schemas, pagination, auth, idempotency, and tool count. Prefer this over generic OpenAPI linters when the goal is agent/LLM usability rather than spec compliance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:34:10.086Z","isFirstParty":false,"canonicalSlug":"latitude-10-api-readiness-report-bafdbdce"}