{ "openapi": "3.1.0", "info": { "title": "DeepCheck KYB v4.0", "version": "5.0.0", "description": "Deterministic SaaS Contract Redlining, DPA & Clause Risk Scoring Engine", "contact": { "name": "AI Cloud Studio", "email": "contact@aicloudstudio.io", "url": "https://deepcheck-kyb.run402.com" } }, "servers": [ { "url": "https://deepcheck-kyb.run402.com", "description": "DeepCheck KYB v4.0 Production Cloud & x402 Gateway" } ], "paths": { "/api/health": { "get": { "operationId": "getHealth", "summary": "Check service health, runtime, and settlement wallets", "responses": { "200": { "description": "Service operational status and wallet metadata" } } } }, "/api/audit": { "get": { "operationId": "runLiveAudit", "summary": "Run live server-side audit on any target URL", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Target HTTPS URL or domain to audit" }, { "name": "unlock", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "1", "true" ] }, "description": "Set unlock=1 to trigger an HTTP 402 (x402Version: 2) payment challenge." } ], "responses": { "200": { "description": "Live server-side audit telemetry and preview deliverable" }, "400": { "description": "Invalid or restricted target URL (SSRF protection)" }, "402": { "description": "x402 Payment Required challenge when unlock=1" }, "502": { "description": "Target host could not be resolved or reached over HTTPS" } } }, "post": { "operationId": "runLiveAuditPost", "summary": "Run live server-side audit via POST JSON payload", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Target HTTPS URL or domain to audit" } } } } } }, "responses": { "200": { "description": "Live server-side audit telemetry and preview deliverable" }, "400": { "description": "Invalid or restricted target URL (SSRF protection)" }, "402": { "description": "x402 Payment Required challenge when unlock=1" }, "502": { "description": "Target host could not be resolved or reached over HTTPS" } } } }, "/api/x402-audit": { "get": { "operationId": "runPaidX402AuditGet", "summary": "HTTP 402 (x402) Paid API endpoint ($0.01 USDC on Base)", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Target HTTPS URL or domain to audit" }, { "name": "payment_proof", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional Base64 x402 payment payload or 0x transaction hash" } ], "responses": { "200": { "description": "Full unredacted audit deliverable returned after valid x402 payment header", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required — returns x402 v1 body and PAYMENT-REQUIRED v2 header" } } }, "post": { "operationId": "runPaidX402AuditPost", "summary": "HTTP 402 (x402) Paid API endpoint ($0.01 USDC on Base)", "responses": { "200": { "description": "Full unredacted audit deliverable returned after valid x402 payment header", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required — returns x402 v1 body and PAYMENT-REQUIRED v2 header" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Target HTTPS URL or domain to audit" } } } } } } } }, "/api/verify-tx": { "post": { "operationId": "verifyOnChainTransaction", "summary": "Verify on-chain Tonkeeper (TON) or Base (USDC/USDT) transaction & unlock full report", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tx_hash": { "type": "string" }, "network": { "type": "string", "enum": [ "ton", "base", "bsc", "polygon", "ethereum" ] }, "url": { "type": "string", "description": "Audited domain or URL to unlock upon verification" }, "plan_price": { "type": "number", "description": "Selected plan price in USD ($3, $29, $800)" } }, "required": [ "tx_hash" ] } } } }, "responses": { "200": { "description": "Verification status returned ({ verified: true, license_key, ... } or { verified: false, pending: true, reason })" }, "400": { "description": "Malformed JSON request body" } } } }, "/api/stats": { "get": { "operationId": "getStats", "summary": "Live PostgreSQL audit & order telemetry", "responses": { "200": { "description": "Real-time PostgreSQL statistics and recent audited domains" } } } }, "/api/x402-pro": { "get": { "operationId": "runPaidX402ProGet", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "default": "https://stripe.com" }, "description": "Target HTTPS URL or domain to audit" } ], "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } }, "post": { "operationId": "runPaidX402ProPost", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Target HTTPS URL or domain to audit" } } } } } }, "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } } }, "/api/x402-buyout": { "get": { "operationId": "runPaidX402BuyoutGet", "summary": "DeepCheck KYB v4.0 — Complete Turnkey LegalTech AI Contract Redliner & GDPR Compliance SaaS Buyout ($800.00 USDC on Base).", "parameters": [ { "name": "buyer_domain", "in": "query", "required": false, "schema": { "type": "string", "default": "enterprise-buyer.com" }, "description": "Acquiring company or buyer domain" } ], "responses": { "200": { "description": "Full turnkey source code archive + IP transfer license", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($800.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } }, "post": { "operationId": "runPaidX402BuyoutPost", "summary": "DeepCheck KYB v4.0 — Complete Turnkey LegalTech AI Contract Redliner & GDPR Compliance SaaS Buyout ($800.00 USDC on Base).", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "buyer_domain" ], "properties": { "buyer_domain": { "type": "string", "description": "Acquiring company or buyer domain" } } } } } }, "responses": { "200": { "description": "Full turnkey source code archive + IP transfer license", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($800.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } } }, "/api/mcp": { "get": { "operationId": "getMcpServerMetadata", "summary": "DeepCheck KYB — Official MCP Streamable HTTP Server Discovery", "responses": { "200": { "description": "MCP Server metadata and available tools" } } }, "post": { "operationId": "invokeMcpJsonRpc", "summary": "DeepCheck KYB — MCP JSON-RPC 2.0 Endpoint (initialize, tools/list, tools/call)", "responses": { "200": { "description": "JSON-RPC 2.0 response" } } } }, "/api/a2a": { "get": { "operationId": "getA2aServerMetadata", "summary": "DeepCheck KYB — Google A2A Agent-to-Agent Discovery", "responses": { "200": { "description": "A2A metadata and supported skills" } } }, "post": { "operationId": "invokeA2aJsonRpc", "summary": "DeepCheck KYB — A2A JSON-RPC 2.0 Task Execution Endpoint", "responses": { "200": { "description": "A2A task result" } } } }, "/api/near-agents": { "get": { "operationId": "getNearAgentStatus", "summary": "DeepCheck KYB — NEAR AI Agent Market 24/7 Auto-Fulfillment Status", "responses": { "200": { "description": "Active NEAR agent status and sample deliverable" } } }, "post": { "operationId": "handleNearAgentWebhook", "summary": "DeepCheck KYB — NEAR AI Agent Market Webhook & Synchronous Task Executor", "responses": { "200": { "description": "Completed deliverable markdown and auto-fulfillment status" } } } }, "/api/inquiry": { "post": { "operationId": "submitBuyerInquiry", "summary": "DeepCheck KYB — Record Buyer Offer or Custom Acquisition Inquiry in PostgreSQL", "responses": { "200": { "description": "Recorded inquiry and direct Base USDC / Tonkeeper settlement details" } } } }, "/api/package-manifest": { "get": { "operationId": "getPackageManifest", "summary": "DeepCheck KYB — Verify SHA-256 Checksums & File Trees of All Turnkey Archives", "responses": { "200": { "description": "Complete SHA-256 package manifest" } } } }, "/api/x402-pro-pack": { "get": { "operationId": "runPaidX402ProGet", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "default": "https://stripe.com" }, "description": "Target HTTPS URL or domain to audit" } ], "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } }, "post": { "operationId": "runPaidX402ProPost", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Target HTTPS URL or domain to audit" } } } } } }, "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } } }, "/api/x402-source-bundle": { "get": { "operationId": "runPaidX402BuyoutGet", "summary": "DeepCheck KYB v4.0 — Complete Turnkey LegalTech AI Contract Redliner & GDPR Compliance SaaS Buyout ($800.00 USDC on Base).", "parameters": [ { "name": "buyer_domain", "in": "query", "required": false, "schema": { "type": "string", "default": "enterprise-buyer.com" }, "description": "Acquiring company or buyer domain" } ], "responses": { "200": { "description": "Full turnkey source code archive + IP transfer license", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($800.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } }, "post": { "operationId": "runPaidX402BuyoutPost", "summary": "DeepCheck KYB v4.0 — Complete Turnkey LegalTech AI Contract Redliner & GDPR Compliance SaaS Buyout ($800.00 USDC on Base).", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "buyer_domain" ], "properties": { "buyer_domain": { "type": "string", "description": "Acquiring company or buyer domain" } } } } } }, "responses": { "200": { "description": "Full turnkey source code archive + IP transfer license", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($800.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } } }, "/api/x402-joint-bundle": { "get": { "operationId": "runPaidX402ProGet", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "parameters": [ { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "default": "https://stripe.com" }, "description": "Target HTTPS URL or domain to audit" } ], "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } }, "post": { "operationId": "runPaidX402ProPost", "summary": "DeepCheck KYB v4.0 — Full Unredacted SaaS Contract Redline, GDPR Art. 28 DPA & EU AI Act Compliance Pack ($1.00 USDC on Base).", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Target HTTPS URL or domain to audit" } } } } } }, "responses": { "200": { "description": "Full unredacted Pro audit + downloadable ZIP bundle", "content": { "application/json": { "schema": { "type": "object", "required": [ "ok", "domain", "geo_score" ], "properties": { "ok": { "type": "boolean", "example": true }, "domain": { "type": "string", "example": "stripe.com" }, "target_url": { "type": "string", "example": "https://stripe.com" }, "geo_score": { "type": "integer", "example": 94 }, "schema_score": { "type": "integer", "example": 96 }, "llms_txt_score": { "type": "integer", "example": 92 }, "has_jsonld": { "type": "boolean", "example": true }, "has_llms_txt": { "type": "boolean", "example": true }, "allows_ai_bots": { "type": "boolean", "example": true }, "generated_jsonld": { "type": "string" }, "generated_llms_txt": { "type": "string" }, "tier": { "type": "string", "example": "pro_x402" } } } } } }, "402": { "description": "Payment Required ($1.00 USDC on Base to 0xbA567fea152c93b38513A44E1da3CBBEe7f3b1DD)" } } } }, "/.well-known/hashn-store.json": { "get": { "summary": "Hashn 15/15 Convention Store Manifest", "responses": { "200": { "description": "OK" } } } }, "/hashn-store.json": { "get": { "summary": "Hashn Store Manifest Alias", "responses": { "200": { "description": "OK" } } } } } }