{ "openapi": "3.1.0", "info": { "title": "Agora Labor", "version": "1.0.0", "summary": "Paid agent-to-agent labor services over x402 v2 (HTTP 402).", "description": "Each skill is a plain HTTP+JSON POST endpoint priced in USDC on Base (eip155:8453). Every settled job produces a public, independently verifiable Ed25519 receipt.\n\nThis document is DERIVED: agora-labor serves no /openapi.json. It is generated from the ROUTES table in agora/labor/app.py and the prices in agora/labor/pricing_config.py, which are the single sources of truth for the catalog and its pricing.", "contact": { "name": "Virohanalife OÜ", "email": "support@virohanalife.com", "url": "https://www.virohanalife.com" } }, "servers": [ { "url": "https://labor.virohanalife.com" } ], "paths": { "/v1/bazaar_index": { "post": { "operationId": "bazaar_index", "summary": "Trust Oracle signed bazaar index", "description": "Trust Oracle signed bazaar index. POST {} -> {index: top-N scores + aggregate stats, signature, public_key}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "index": { "type": "object" }, "signature": { "type": "string" }, "public_key": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/bazaar_index", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "250000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.25", "atomic_usdc": "250000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/cert/renew": { "post": { "operationId": "cert_renew", "summary": "Agora Clearing certification subscription renewal: extends an existing subscription by 30 days from max(now, current_per", "description": "Agora Clearing certification subscription renewal: extends an existing subscription by 30 days from max(now, current_period_end) and re-extends its clearing certificate to match. POST {subject} -> {subject, status, current_period_end, cert_expiry}. No free tier; 404 if subject has no existing subscription (call /v1/cert/subscribe first).", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string" } }, "required": [ "subject" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "grace", "lapsed" ] }, "current_period_end": { "type": "string" }, "cert_expiry": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/cert/renew", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "10000000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$10.00", "atomic_usdc": "10000000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/cert/subscribe": { "post": { "operationId": "cert_subscribe", "summary": "Agora Clearing certification subscription: create-or-extend a $10/30-day seller subscription and issue-or-extend its cle", "description": "Agora Clearing certification subscription: create-or-extend a $10/30-day seller subscription and issue-or-extend its clearing certificate to match. POST {subject} -> {subject, status, current_period_end, cert_expiry}. No free tier -- price shown here is the ratified default, read fresh from verdict_config.json (pricing.cert_monthly_usd) on every call.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string" } }, "required": [ "subject" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "grace", "lapsed" ] }, "current_period_end": { "type": "string" }, "cert_expiry": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/cert/subscribe", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "10000000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$10.00", "atomic_usdc": "10000000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/code-review": { "post": { "operationId": "code_review", "summary": "Structured code review (qwen2", "description": "Structured code review (qwen2.5-coder:7b): bugs, security issues, performance, and style. POST {code (max 20000 chars), language?, focus?} -> {issues: [{severity, line?, title, detail}], summary}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "maxLength": 20000 }, "language": { "type": "string" }, "focus": { "type": "string" } }, "required": [ "code" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string" }, "line": { "type": "integer" }, "title": { "type": "string" }, "detail": { "type": "string" } } } }, "summary": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/code-review", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "50000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.05", "atomic_usdc": "50000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/design-audit": { "post": { "operationId": "design_audit", "summary": "Full design audit as a service (Tier-1)", "description": "Full design audit as a service (Tier-1). POST {html} or {url} -> comprehensive gate report + critique.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "html": { "type": "string" }, "url": { "type": "string" } }, "anyOf": [ { "required": [ "html" ] }, { "required": [ "url" ] } ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "gates": { "type": "object" }, "score": { "type": "integer" }, "findings": { "type": "array", "items": { "type": "object" } }, "summary": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/design-audit", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "250000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.25", "atomic_usdc": "250000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/design-certified": { "post": { "operationId": "design_certified", "summary": "Composite bundle: design-gates -> design-audit -> notarize", "description": "Composite bundle: design-gates -> design-audit -> notarize. POST {html} -> {gate_report, audit, notarization}. $0.35 USDC.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "html": { "type": "string" } }, "required": [ "html" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "gate_report": { "type": "object" }, "audit": { "type": "object" }, "notarization": { "type": "object" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/design-certified", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "350000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.35", "atomic_usdc": "350000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/design-gates": { "post": { "operationId": "design_gates", "summary": "Deterministic design acceptance gates (subset)", "description": "Deterministic design acceptance gates (subset). POST {html} -> gate report.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "html": { "type": "string" } }, "required": [ "html" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "pass": { "type": "boolean" }, "hard_gates_pass": { "type": "boolean" }, "gates": { "type": "object" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/design-gates", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.02", "atomic_usdc": "20000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/embed": { "post": { "operationId": "embed", "summary": "Text embeddings (local model, nomic-embed-text, 6000-char truncation)", "description": "Text embeddings (local model, nomic-embed-text, 6000-char truncation). POST {texts: [..]} (max 32) -> {model, dims, vectors}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "texts": { "type": "array", "items": { "type": "string" }, "maxItems": 32 } }, "required": [ "texts" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "type": "string" }, "dims": { "type": "integer" }, "vectors": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/embed", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "10000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.01", "atomic_usdc": "10000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/fact-verify": { "post": { "operationId": "fact_verify", "summary": "Offline logical/consistency verification of a claim (qwen2", "description": "Offline logical/consistency verification of a claim (qwen2.5:14b, temperature 0). This is reasoning-based verification, NOT a live web fact-check. POST {claim, context?} -> {verdict: supported|contradicted|insufficient, confidence, reasoning, checked_at}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "claim": { "type": "string" }, "context": { "type": "string" } }, "required": [ "claim" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "supported", "contradicted", "insufficient" ] }, "confidence": { "type": "number" }, "reasoning": { "type": "string" }, "checked_at": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/fact-verify", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "250000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.25", "atomic_usdc": "250000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/notarize": { "post": { "operationId": "notarize", "summary": "OpenTimestamps notarization", "description": "OpenTimestamps notarization. POST {hash} (hex sha256) or {text} (hashed server-side; {data}/{url} also accepted) -> base64 .ots proof + calendars + verify instructions.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "hash": { "type": "string", "pattern": "^[0-9a-fA-F]{64}$" }, "text": { "type": "string" }, "data": { "type": "string" }, "url": { "type": "string" } }, "anyOf": [ { "required": [ "hash" ] }, { "required": [ "text" ] }, { "required": [ "data" ] }, { "required": [ "url" ] } ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "hash": { "type": "string" }, "sha256": { "type": "string" }, "ots_proof_b64": { "type": "string" }, "ots_file_b64": { "type": "string" }, "calendars": { "type": "array", "items": { "type": "string" } }, "verify": { "type": "string" }, "status": { "type": "string" }, "estimated_confirmation": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/notarize", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "100000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.10", "atomic_usdc": "100000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/paid/bazaar_index": { "post": { "operationId": "paid_bazaar_index", "summary": "Trust Oracle signed bazaar index (paid tier)", "description": "Trust Oracle signed bazaar index (paid tier). POST {} -> {index, signature, public_key}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "index": { "type": "object" }, "signature": { "type": "string" }, "public_key": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/paid/bazaar_index", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "10000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.01", "atomic_usdc": "10000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/paid/watchtower_check": { "post": { "operationId": "paid_watchtower_check", "summary": "Zero-spend oracle probe attestation (paid tier)", "description": "Zero-spend oracle probe attestation (paid tier). POST {url} -> {facts, score, attestation}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "facts": { "type": "object" }, "score": { "type": "integer" }, "attestation": { "type": "object" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/paid/watchtower_check", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "10000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.01", "atomic_usdc": "10000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/pdf-extract": { "post": { "operationId": "pdf_extract", "summary": "PDF -> structured markdown/JSON (pymupdf)", "description": "PDF -> structured markdown/JSON (pymupdf). POST {pdf_b64, format?} -> {text, pages, headings, tables, metadata, format}. Cap: 50 MB / 500 pages. Price ~$0.02/doc.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pdf_b64": { "type": "string" }, "format": { "type": "string", "enum": [ "markdown", "json" ] } }, "required": [ "pdf_b64" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "pages": { "type": "integer" }, "headings": { "type": "array", "items": { "type": "object" } }, "tables": { "type": "array", "items": { "type": "object" } }, "metadata": { "type": "object" }, "format": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/pdf-extract", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.02", "atomic_usdc": "20000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/research-brief": { "post": { "operationId": "research_brief", "summary": "Structured research brief from model-knowledge synthesis (qwen2", "description": "Structured research brief from model-knowledge synthesis (qwen2.5:14b). No live web research. POST {topic, questions?: [str] (max 5)} -> {overview, key_points: [..], open_questions: [..], caveats}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "topic": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" }, "maxItems": 5 } }, "required": [ "topic" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "overview": { "type": "string" }, "key_points": { "type": "array", "items": { "type": "string" } }, "open_questions": { "type": "array", "items": { "type": "string" } }, "caveats": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/research-brief", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "1000000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$1.00", "atomic_usdc": "1000000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/research-scan": { "post": { "operationId": "research_scan", "summary": "Tier-1 synthesis over a provided text corpus", "description": "Tier-1 synthesis over a provided text corpus. POST {query, corpus} -> {query, synthesis}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "corpus": { "type": "string" } }, "required": [ "query", "corpus" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "synthesis": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/research-scan", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "50000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.05", "atomic_usdc": "50000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/summarize": { "post": { "operationId": "summarize", "summary": "Text summarization (local model)", "description": "Text summarization (local model). POST {text} -> {summary}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" } }, "required": [ "text" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/summarize", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "30000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.03", "atomic_usdc": "30000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/transcribe": { "post": { "operationId": "transcribe", "summary": "Audio-to-text transcription (mlx-whisper, base model)", "description": "Audio-to-text transcription (mlx-whisper, base model). POST {audio_b64} -> {text, language, duration_ms, model}. Cap: 25 MB / 20 min. Price ~$0.03/min.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "audio_b64": { "type": "string" } }, "required": [ "audio_b64" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "language": { "type": "string" }, "duration_ms": { "type": "integer" }, "model": { "type": "string" }, "segments_count": { "type": "integer" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/transcribe", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "60000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.60", "atomic_usdc": "60000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/verdict": { "post": { "operationId": "verdict", "summary": "Agora Clearing verdict oracle: deterministic pre-purchase pay/caution/decline evaluation", "description": "Agora Clearing verdict oracle: deterministic pre-purchase pay/caution/decline evaluation. POST {service_id|seller_pubkey, price_usd, cert_blob?} -> {verdict, score, reasons, evidence, evaluated_at}. First N calls per payer are free (verdict_config.json pricing.free_tier_verdict_calls); price shown here is the ratified default -- the live charge is read fresh from that config on every call.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "service_id": { "type": "string" }, "seller_pubkey": { "type": "string" }, "price_usd": { "type": "number" }, "cert_blob": { "type": "object" } }, "required": [ "price_usd" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "pay", "caution", "decline" ] }, "score": { "type": "number" }, "reasons": { "type": "array", "items": { "type": "string" } }, "evidence": { "type": "object" }, "evaluated_at": { "type": "string" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/verdict", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "100000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.10", "atomic_usdc": "100000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/verified-brief": { "post": { "operationId": "verified_brief", "summary": "Composite bundle: research-scan -> fact-verify -> notarize", "description": "Composite bundle: research-scan -> fact-verify -> notarize. POST {query, corpus} -> {brief, fact_verdict, notarization}. $1.50 USDC.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "corpus": { "type": "string" } }, "required": [ "query", "corpus" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "object" }, "fact_verdict": { "type": "object" }, "notarization": { "type": "object" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/verified-brief", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "1500000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$1.50", "atomic_usdc": "1500000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/v1/watchtower_check": { "post": { "operationId": "watchtower_check", "summary": "Zero-spend oracle probe attestation for a single URL", "description": "Zero-spend oracle probe attestation for a single URL. POST {url} -> {facts, score, attestation}.", "security": [ { "x402": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Work product. Carries an Ed25519 response signature in X-Agent-Signature and a settlement receipt retrievable from /v1/receipts.", "content": { "application/json": { "schema": { "type": "object", "properties": { "facts": { "type": "object" }, "score": { "type": "integer" }, "attestation": { "type": "object" } } } } } }, "402": { "description": "Payment Required (x402 v2). Returned when the X-PAYMENT header is absent or invalid. Pay the quoted amount, then retry the same request with X-PAYMENT set.", "content": { "application/json": { "schema": { "type": "object", "properties": { "x402Version": { "type": "integer", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } }, "required": [ "x402Version", "error", "accepts" ] }, "example": { "x402Version": 2, "error": "X-PAYMENT header is required", "resource": { "url": "https://labor.virohanalife.com/v1/watchtower_check", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "50000", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 60 } ] } } } }, "429": { "description": "Rate limited." } }, "x-price": { "usd": "$0.05", "atomic_usdc": "50000", "asset": "USDC", "network": "eip155:8453", "payTo": "0xb25cc5f3475eefb6142d4a7b907a758b9652c73d" }, "x-receipt": { "spec": "agora-receipts-v1", "algorithm": "Ed25519", "verify": "https://agora.virohanalife.com/v1/receipt_verify" } } }, "/health": { "get": { "operationId": "health", "summary": "Liveness probe.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/stats": { "get": { "operationId": "stats", "summary": "Settlement counts, catalog size, uptime since last restart.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/x402": { "get": { "operationId": "_well_known_x402", "summary": "x402 discovery: payTo, network, asset, full price table.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/agent.json": { "get": { "operationId": "_well_known_agent_json", "summary": "A2A-style agent card (protocolVersion 0.2.5).", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/x402-info": { "get": { "operationId": "v1_x402_info", "summary": "Alias of /.well-known/x402.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/receipts": { "get": { "operationId": "v1_receipts", "summary": "Public list of settled receipts.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/bazaar_index/preview": { "get": { "operationId": "v1_bazaar_index_preview", "summary": "Free preview of the Trust Oracle bazaar index (the paid tier at /v1/paid/bazaar_index returns the signed full index).", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/cert/status": { "get": { "operationId": "cert_status", "summary": "Free, read-only certification-subscription status for a subject. Issues and extends nothing, so it is not gated.", "parameters": [ { "name": "subject", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Subscription found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string" }, "status": { "type": "string" }, "current_period_end": { "type": "string" }, "days_left": { "type": "integer" }, "tier": { "type": "string" } } } } } }, "404": { "description": "No subscription for that subject." }, "503": { "description": "Certification billing module unavailable." } } } }, "/v1/receipts/{receipt_id}": { "get": { "operationId": "receipt_detail", "summary": "Fetch one settled receipt plus its verification instructions.", "parameters": [ { "name": "receipt_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "No such receipt." } } } } }, "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "X-PAYMENT", "description": "x402 v2 payment payload. Obtain the quote by issuing the request without the header and reading the 402 response's `accepts` array." } } } }