{"openapi":"3.1.0","info":{"title":"NexusEval Agent Procurement Passport API","version":"2.0.0","description":"Buyer-ready vendor and endpoint preflight decisions for autonomous agents. Each POST is paid in USDC through x402 on Base."},"servers":[{"url":"https://nexuseval.vercel.app"}],"tags":[{"name":"agent-procurement","description":"Pre-spend evidence and risk checks for APIs, MCP servers, agents, and AI vendors."}],"paths":{"/api/procurement-passport/instant":{"post":{"operationId":"createInstantProcurementPassport","summary":"Agent Procurement Passport — Instant","description":"Use before an agent pays an unfamiliar API, MCP server or agent. Returns a machine-readable PASS/WARN/BLOCK procurement preflight, missing-evidence list, risk flags and deterministic evidence hash.","tags":["agent-procurement"],"x-x402-price":"$0.25","x-payment-info":{"currency":"USDC","network":"eip155:8453","payTo":"0x756A9769725aF78F81fb0A9b66300aBb64A0551c"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vendor","endpoint"],"properties":{"vendor":{"type":"string","minLength":2,"maxLength":160,"description":"Vendor, agent, MCP server or API name."},"endpoint":{"type":"string","pattern":"^https://","description":"Public HTTPS service endpoint to assess."},"termsUrl":{"type":"string","pattern":"^https://"},"privacyUrl":{"type":"string","pattern":"^https://"},"securityUrl":{"type":"string","pattern":"^https://"},"statusUrl":{"type":"string","pattern":"^https://"},"pricingUrl":{"type":"string","pattern":"^https://"},"legalEntity":{"type":"string"},"evidence":{"type":"array","items":{"type":"string"},"maxItems":30},"documents":{"type":"array","items":{"type":"string"},"maxItems":30},"claims":{"type":"array","items":{"type":"string"},"maxItems":30}}},"example":{"vendor":"Example Agent API","endpoint":"https://api.example.com/v1/report","termsUrl":"https://example.com/terms","privacyUrl":"https://example.com/privacy","securityUrl":"https://example.com/security","statusUrl":"https://status.example.com","pricingUrl":"https://example.com/pricing","legalEntity":"Example Labs Inc.","evidence":["public documentation","service status page","pricing page"]}}}},"responses":{"200":{"description":"Paid structured procurement decision","content":{"application/json":{"example":{"service":"NexusEval Agent Procurement Passport","offer":"instant","price":"$0.25 USDC","result":{"schema":"nexuseval.agent-procurement-passport/1.0","depth":"instant","vendor":"Example Agent API","endpoint":"https://api.example.com/v1/report","decision":"WARN","score":72,"evidenceCoverage":60,"strengths":["vendor_identified","https_endpoint","terms_available"],"risks":["operator_identity_missing"],"recommendation":"Request missing evidence before autonomous spend approval.","evidenceHash":"sha256:<deterministic-hash>"}}}}},"402":{"description":"x402 USDC payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements with Bazaar discovery metadata."}}},"503":{"description":"Payment facilitator temporarily unavailable; no payment requested."}}}},"/api/procurement-passport/deep":{"post":{"operationId":"createDeepProcurementPassport","summary":"Agent Procurement Passport — Deep","description":"Use for a deeper autonomous-spend review of an API, MCP server or agent. Returns expanded operational, security, privacy, commercial and continuity evidence scoring with prioritized gaps.","tags":["agent-procurement"],"x-x402-price":"$2.99","x-payment-info":{"currency":"USDC","network":"eip155:8453","payTo":"0x756A9769725aF78F81fb0A9b66300aBb64A0551c"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vendor","endpoint"],"properties":{"vendor":{"type":"string","minLength":2,"maxLength":160,"description":"Vendor, agent, MCP server or API name."},"endpoint":{"type":"string","pattern":"^https://","description":"Public HTTPS service endpoint to assess."},"termsUrl":{"type":"string","pattern":"^https://"},"privacyUrl":{"type":"string","pattern":"^https://"},"securityUrl":{"type":"string","pattern":"^https://"},"statusUrl":{"type":"string","pattern":"^https://"},"pricingUrl":{"type":"string","pattern":"^https://"},"legalEntity":{"type":"string"},"evidence":{"type":"array","items":{"type":"string"},"maxItems":30},"documents":{"type":"array","items":{"type":"string"},"maxItems":30},"claims":{"type":"array","items":{"type":"string"},"maxItems":30}}},"example":{"vendor":"Example Agent API","endpoint":"https://api.example.com/v1/report","termsUrl":"https://example.com/terms","privacyUrl":"https://example.com/privacy","securityUrl":"https://example.com/security","statusUrl":"https://status.example.com","pricingUrl":"https://example.com/pricing","legalEntity":"Example Labs Inc.","evidence":["public documentation","service status page","pricing page"]}}}},"responses":{"200":{"description":"Paid structured procurement decision","content":{"application/json":{"example":{"service":"NexusEval Agent Procurement Passport","offer":"deep","price":"$2.99 USDC","result":{"schema":"nexuseval.agent-procurement-passport/1.0","depth":"deep","vendor":"Example Agent API","endpoint":"https://api.example.com/v1/report","decision":"WARN","score":72,"evidenceCoverage":60,"strengths":["vendor_identified","https_endpoint","terms_available"],"risks":["operator_identity_missing"],"recommendation":"Request missing evidence before autonomous spend approval.","evidenceHash":"sha256:<deterministic-hash>"}}}}},"402":{"description":"x402 USDC payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements with Bazaar discovery metadata."}}},"503":{"description":"Payment facilitator temporarily unavailable; no payment requested."}}}}}}