{"openapi":"3.1.0","info":{"title":"Burs-IA x402 Agent Services","version":"1.3.0","description":"Machine-payable Burs-IA agent readiness and interoperability services over x402 v2.","x-guidance":"Use GET /x402/agent-check for a paid, deterministic Burs-IA Agent Check. Use POST /x402/verify-agent-card-canonicality with agentCardUrl for the live read-only AGENT_CARD_CANONICALITY microproduct at the existing Agent Check price. Optionally pass agent_ref as a public HTTPS Agent Card URL for bounded read-only interoperability analysis. An unpaid request returns HTTP 402 with x402 v2 Base-mainnet USDC requirements in PAYMENT-REQUIRED; retry the same request after signing the advertised payment. Use GET /x402/catalog and /.well-known/x402.json for machine-readable service discovery. POST /need is free public-safe intake and does not create a quote, payment intent, Resident assignment or execution."},"servers":[{"url":"https://bursia-x402-testnet-runner-production.up.railway.app"}],"paths":{"/x402/test/verify-receipt":{"post":{"operationId":"bursiaTestnetRECEIPTVERIFY","summary":"Testnet Receipt Verify","description":"Receipt Verify. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["receipt"],"properties":{"receipt":{"type":"object"},"format":{"type":"string","enum":["AUTO","BURSIA","X402_GENERIC"]},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-receipt":{"post":{"operationId":"bursiaLiveRECEIPTVERIFY","summary":"Live Receipt Verify","tags":["Agents","Verification","x402"],"description":"Receipt Verify. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.002.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["receipt"],"properties":{"receipt":{"type":"object"},"format":{"type":"string","enum":["AUTO","BURSIA","X402_GENERIC"]},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.002."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-tool-contract":{"post":{"operationId":"bursiaTestnetTOOLAPICONTRACTPREFLIGHT","summary":"Testnet Tool/API Contract Preflight","description":"Tool/API Contract Preflight. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["document"],"properties":{"document":{"type":"object","description":"OpenAPI 3.x document."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-tool-contract":{"post":{"operationId":"bursiaLiveTOOLAPICONTRACTPREFLIGHT","summary":"Live Tool/API Contract Preflight","tags":["Agents","Verification","x402"],"description":"Tool/API Contract Preflight. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["document"],"properties":{"document":{"type":"object","description":"OpenAPI 3.x document."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-url":{"post":{"operationId":"bursiaTestnetURLTLSPUBLICCHECK","summary":"Testnet Public URL/TLS Check","description":"Public URL/TLS Check. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-url":{"post":{"operationId":"bursiaLiveURLTLSPUBLICCHECK","summary":"Live Public URL/TLS Check","tags":["Agents","Verification","x402"],"description":"Public URL/TLS Check. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-x402-seller":{"post":{"operationId":"bursiaTestnetX402SELLERPREFLIGHT","summary":"Testnet x402 Seller Preflight","description":"x402 Seller Preflight. Unpaid preflight only; never purchases the third-party resource. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string","enum":["GET","HEAD"],"default":"GET"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-x402-seller":{"post":{"operationId":"bursiaLiveX402SELLERPREFLIGHT","summary":"Live x402 Seller Preflight","tags":["Agents","Verification","x402"],"description":"x402 Seller Preflight. Unpaid preflight only; never purchases the third-party resource. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.005.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string","enum":["GET","HEAD"],"default":"GET"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.005."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-mcp-quick":{"post":{"operationId":"bursiaTestnetMCPQUICKCHECK","summary":"Testnet MCP Quick Check","description":"MCP Quick Check. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint","protocolVersion"],"properties":{"endpoint":{"type":"string","format":"uri"},"protocolVersion":{"type":"string","enum":["2026-07-28","2025-11-25","2025-06-18"]},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-mcp-quick":{"post":{"operationId":"bursiaLiveMCPQUICKCHECK","summary":"Live MCP Quick Check","tags":["Agents","Verification","x402"],"description":"MCP Quick Check. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.005.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint","protocolVersion"],"properties":{"endpoint":{"type":"string","format":"uri"},"protocolVersion":{"type":"string","enum":["2026-07-28","2025-11-25","2025-06-18"]},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.005."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-mcp-2026":{"post":{"operationId":"bursiaTestnetMCP2026COMPAT","summary":"Testnet MCP 2026-07-28 Compatibility","description":"MCP 2026-07-28 Compatibility. PASS requires observed MCP server/discover plus tools/list under protocol 2026-07-28; requesting that version alone is insufficient. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint"],"properties":{"endpoint":{"type":"string","format":"uri"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-mcp-2026":{"post":{"operationId":"bursiaLiveMCP2026COMPAT","summary":"Live MCP 2026-07-28 Compatibility","tags":["Agents","Verification","x402"],"description":"MCP 2026-07-28 Compatibility. PASS requires observed MCP server/discover plus tools/list under protocol 2026-07-28; requesting that version alone is insufficient. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.005.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint"],"properties":{"endpoint":{"type":"string","format":"uri"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.005."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-a2a-card":{"post":{"operationId":"bursiaTestnetA2ACARDVALIDATE","summary":"Testnet A2A v1.0 Agent Card Validate","description":"A2A v1.0 Agent Card Validate. Validates A2A v1.0 structure and verifies at least one JWS signature over the RFC 8785 canonicalized Agent Card using public HTTPS JWKS from protected jku/kid. A valid signature proves integrity against the card-declared public key, not independent identity certification. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["card"],"properties":{"card":{"type":"object","description":"A2A v1.0 Agent Card. Signed cards are verified with RFC 8785 + JWS using public HTTPS JWKS from protected jku/kid."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-a2a-card":{"post":{"operationId":"bursiaLiveA2ACARDVALIDATE","summary":"Live A2A v1.0 Agent Card Validate","tags":["Agents","Verification","x402"],"description":"A2A v1.0 Agent Card Validate. Validates A2A v1.0 structure and verifies at least one JWS signature over the RFC 8785 canonicalized Agent Card using public HTTPS JWKS from protected jku/kid. A valid signature proves integrity against the card-declared public key, not independent identity certification. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["card"],"properties":{"card":{"type":"object","description":"A2A v1.0 Agent Card. Signed cards are verified with RFC 8785 + JWS using public HTTPS JWKS from protected jku/kid."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-agent-card-canonicality":{"post":{"operationId":"bursiaTestnetAGENTCARDCANONICALITY","summary":"Testnet Agent Card Canonicality","description":"Agent Card Canonicality. Fetches a public Agent Card and, when declared, its canonical Agent Card; compares bounded identity, service URL, version, protocol and skill-set semantics plus document digests. It does not certify identity or security. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["agentCardUrl"],"properties":{"agentCardUrl":{"type":"string","format":"uri","description":"Public HTTPS Agent Card URL whose declared canonical surface will be compared read-only."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}},"example":{"agentCardUrl":"https://agent.example/.well-known/agent-card.json"}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-agent-card-canonicality":{"get":{"operationId":"bursiaDiscoverAgentCardCanonicality","summary":"Free discovery for Agent Card Canonicality","description":"Returns purchase metadata and the required POST method without executing verification or requiring payment.","tags":["Agents","A2A","Trust","Verification","x402"],"responses":{"200":{"description":"Machine-readable purchase guidance. No verification executed and no payment recorded."}}},"post":{"operationId":"bursiaLiveAGENTCARDCANONICALITY","summary":"Live Agent Card Canonicality","tags":["Agents","A2A","Trust","Verification","x402"],"description":"Agent Card Canonicality. Fetches a public Agent Card and, when declared, its canonical Agent Card; compares bounded identity, service URL, version, protocol and skill-set semantics plus document digests. It does not certify identity or security. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.005.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["agentCardUrl"],"properties":{"agentCardUrl":{"type":"string","format":"uri","description":"Public HTTPS Agent Card URL whose declared canonical surface will be compared read-only."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}},"example":{"agentCardUrl":"https://agent.example/.well-known/agent-card.json"}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned.","content":{"application/json":{"example":{"report":{"serviceId":"AGENT_CARD_CANONICALITY","valid":true,"status":"PASS","canonicalChecked":true,"findings":[],"evidenceHash":"<sha256>"},"receipt":{"schema":"BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1","status":"DELIVERED","serviceId":"AGENT_CARD_CANONICALITY","settlementConfirmed":true,"resultHash":"<sha256>","coreMutation":false,"customerFundsCustody":false}}}}},"402":{"description":"x402 v2 Base-mainnet payment required at $0.005."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-mcp-retry-safety":{"post":{"operationId":"bursiaTestnetMCPRETRYIDEMPOTENCYPREFLIGHT","summary":"Testnet MCP Mutating Tool Retry Safety","description":"MCP Mutating Tool Retry Safety. Checks a mutating-tool contract for request-bound idempotency, read-back-before-retry, blind-retry prohibition and side-effect receipts; it never invokes the tool. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contract"],"properties":{"contract":{"type":"object","additionalProperties":false,"required":["toolName","mutationPossible","idempotencyKeySupported","idempotencyKeyBoundToRequest","readbackBeforeRetry","blindRetryForbidden","sideEffectReceiptSupported"],"properties":{"toolName":{"type":"string","maxLength":160},"mutationPossible":{"type":"boolean"},"idempotencyKeySupported":{"type":"boolean"},"idempotencyKeyBoundToRequest":{"type":"boolean"},"readbackBeforeRetry":{"type":"boolean"},"blindRetryForbidden":{"type":"boolean"},"sideEffectReceiptSupported":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-mcp-retry-safety":{"post":{"operationId":"bursiaLiveMCPRETRYIDEMPOTENCYPREFLIGHT","summary":"Live MCP Mutating Tool Retry Safety","tags":["Agents","Verification","x402"],"description":"MCP Mutating Tool Retry Safety. Checks a mutating-tool contract for request-bound idempotency, read-back-before-retry, blind-retry prohibition and side-effect receipts; it never invokes the tool. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contract"],"properties":{"contract":{"type":"object","additionalProperties":false,"required":["toolName","mutationPossible","idempotencyKeySupported","idempotencyKeyBoundToRequest","readbackBeforeRetry","blindRetryForbidden","sideEffectReceiptSupported"],"properties":{"toolName":{"type":"string","maxLength":160},"mutationPossible":{"type":"boolean"},"idempotencyKeySupported":{"type":"boolean"},"idempotencyKeyBoundToRequest":{"type":"boolean"},"readbackBeforeRetry":{"type":"boolean"},"blindRetryForbidden":{"type":"boolean"},"sideEffectReceiptSupported":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-mcp-token-boundary":{"post":{"operationId":"bursiaTestnetMCPTOKENBOUNDARYPREFLIGHT","summary":"Testnet MCP Token Audience Boundary","description":"MCP Token Audience Boundary. Checks issuer/audience/scope boundaries without accepting raw access tokens or Authorization secrets. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["policy"],"properties":{"policy":{"type":"object","additionalProperties":false,"required":["issuer","audience","scopes","tokenPassthrough","crossServerReuseAllowed","leastPrivilegeScopesExplicit"],"properties":{"issuer":{"type":"string"},"audience":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"},"maxItems":64},"tokenPassthrough":{"type":"boolean"},"crossServerReuseAllowed":{"type":"boolean"},"leastPrivilegeScopesExplicit":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}},"description":"Raw access tokens, Authorization headers and bearer secrets are forbidden input."}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-mcp-token-boundary":{"post":{"operationId":"bursiaLiveMCPTOKENBOUNDARYPREFLIGHT","summary":"Live MCP Token Audience Boundary","tags":["Agents","Verification","x402"],"description":"MCP Token Audience Boundary. Checks issuer/audience/scope boundaries without accepting raw access tokens or Authorization secrets. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["policy"],"properties":{"policy":{"type":"object","additionalProperties":false,"required":["issuer","audience","scopes","tokenPassthrough","crossServerReuseAllowed","leastPrivilegeScopesExplicit"],"properties":{"issuer":{"type":"string"},"audience":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"},"maxItems":64},"tokenPassthrough":{"type":"boolean"},"crossServerReuseAllowed":{"type":"boolean"},"leastPrivilegeScopesExplicit":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}},"description":"Raw access tokens, Authorization headers and bearer secrets are forbidden input."}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-mcp-oauth-discovery":{"post":{"operationId":"bursiaTestnetMCPOAUTHDISCOVERYSSRFCHECK","summary":"Testnet MCP OAuth Discovery SSRF Check","description":"MCP OAuth Discovery SSRF Check. Reads only public HTTPS OAuth metadata with pinned public resolution; it does not follow redirects or use credentials. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["metadataUrl"],"properties":{"metadataUrl":{"type":"string","format":"uri","description":"Public HTTPS OAuth authorization-server metadata URL."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-mcp-oauth-discovery":{"post":{"operationId":"bursiaLiveMCPOAUTHDISCOVERYSSRFCHECK","summary":"Live MCP OAuth Discovery SSRF Check","tags":["Agents","Verification","x402"],"description":"MCP OAuth Discovery SSRF Check. Reads only public HTTPS OAuth metadata with pinned public resolution; it does not follow redirects or use credentials. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.005.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["metadataUrl"],"properties":{"metadataUrl":{"type":"string","format":"uri","description":"Public HTTPS OAuth authorization-server metadata URL."},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.005."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-a2a-security-boundary":{"post":{"operationId":"bursiaTestnetA2AAUTHPUSHWEBHOOKPREFLIGHT","summary":"Testnet A2A Auth and Push Webhook Preflight","description":"A2A Auth and Push Webhook Preflight. Resolves the push webhook as a public HTTPS target and checks declared least-privilege auth boundaries; it never sends a push request. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["pushWebhookUrl","auth"],"properties":{"pushWebhookUrl":{"type":"string","format":"uri"},"auth":{"type":"object","additionalProperties":false,"required":["scheme","leastPrivilegeScopesExplicit","credentialsInTaskPayload"],"properties":{"scheme":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"},"maxItems":64},"leastPrivilegeScopesExplicit":{"type":"boolean"},"credentialsInTaskPayload":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-a2a-security-boundary":{"post":{"operationId":"bursiaLiveA2AAUTHPUSHWEBHOOKPREFLIGHT","summary":"Live A2A Auth and Push Webhook Preflight","tags":["Agents","Verification","x402"],"description":"A2A Auth and Push Webhook Preflight. Resolves the push webhook as a public HTTPS target and checks declared least-privilege auth boundaries; it never sends a push request. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.004.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["pushWebhookUrl","auth"],"properties":{"pushWebhookUrl":{"type":"string","format":"uri"},"auth":{"type":"object","additionalProperties":false,"required":["scheme","leastPrivilegeScopesExplicit","credentialsInTaskPayload"],"properties":{"scheme":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"},"maxItems":64},"leastPrivilegeScopesExplicit":{"type":"boolean"},"credentialsInTaskPayload":{"type":"boolean"}}},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.004."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-x402-replay":{"post":{"operationId":"bursiaTestnetX402REPLAYDEDUPVERIFY","summary":"Testnet x402 Replay and Dedup Receipt Verify","description":"x402 Replay and Dedup Receipt Verify. Compares two receipts for quote, payment fingerprint, settlement hash, status and result consistency; it never pays or settles. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["firstReceipt","replayReceipt"],"properties":{"firstReceipt":{"type":"object"},"replayReceipt":{"type":"object"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-x402-replay":{"post":{"operationId":"bursiaLiveX402REPLAYDEDUPVERIFY","summary":"Live x402 Replay and Dedup Receipt Verify","tags":["Agents","Verification","x402"],"description":"x402 Replay and Dedup Receipt Verify. Compares two receipts for quote, payment fingerprint, settlement hash, status and result consistency; it never pays or settles. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["firstReceipt","replayReceipt"],"properties":{"firstReceipt":{"type":"object"},"replayReceipt":{"type":"object"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/x402/test/verify-x402-delivery-receipt":{"post":{"operationId":"bursiaTestnetX402DELIVERYRECEIPTBINDING","summary":"Testnet x402 Delivery Receipt Binding Verify","description":"x402 Delivery Receipt Binding Verify. Checks that settlement and delivery/result fields form a coherent final receipt, including the PAID_NOT_DELIVERED refund-review boundary. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Base Sepolia is testnet and never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["receipt"],"properties":{"receipt":{"type":"object"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed; verification result + BURSIA_PAID_READONLY_VERIFICATION_RECEIPT_V1 returned."},"400":{"description":"Input rejected before payment."},"402":{"description":"x402 v2 quote/payment required, or settlement not confirmed."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Settlement ambiguous or paid request not delivered; human refund review required."}}}},"/x402/verify-x402-delivery-receipt":{"post":{"operationId":"bursiaLiveX402DELIVERYRECEIPTBINDING","summary":"Live x402 Delivery Receipt Binding Verify","tags":["Agents","Verification","x402"],"description":"x402 Delivery Receipt Binding Verify. Checks that settlement and delivery/result fields form a coherent final receipt, including the PAID_NOT_DELIVERED refund-review boundary. Read-only, deterministic QA, settlement-before-execution, durable receipt, no customer-funds custody. Live on Base mainnet at the founder-approved SKU price $0.003.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["receipt"],"properties":{"receipt":{"type":"object"},"quoteId":{"type":"string","description":"Quote identifier returned by the initial HTTP 402."}}}}}},"responses":{"200":{"description":"Confirmed live settlement; verification result + durable receipt returned."},"402":{"description":"x402 v2 Base-mainnet payment required at $0.003."},"403":{"description":"Not returned while the founder-approved read-only Utility Grid class remains active."},"429":{"description":"Bounded quote issuance or destination-host precharge limit exceeded."},"502":{"description":"Paid request not delivered; human refund review required."}}}},"/api/reliability":{"get":{"operationId":"bursiaSellerReliability","summary":"Free machine-readable Burs-IA seller reliability","description":"Free seller-side runtime, self-probe, capacity and delivery-semantics read-back. No payment or account required.","responses":{"200":{"description":"Current seller reliability document."}}}},"/need":{"post":{"operationId":"bursiaSubmitNeed","summary":"Submit a public-safe need to Burs-IA","description":"Free machine intake. ACCEPT means durable admission for WORKNET qualification only; no binding scope, price, payment intent, Resident assignment or execution is created.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["need","constraints"],"properties":{"need":{"type":"string","maxLength":4000},"inputs":{},"desiredOutput":{},"constraints":{"type":"object","properties":{"publicSafe":{"type":"boolean","const":true}}},"deadline":{},"maxBudget":{}}}}}},"responses":{"202":{"description":"ACCEPT — durably admitted for qualification."},"400":{"description":"REJECT — malformed or outside intake bounds."},"409":{"description":"HUMAN_GATE — protected authority/private data/credential boundary."},"422":{"description":"NEED_MORE_INFO — safe qualification data is missing."},"503":{"description":"Fail closed when durable intake storage is unavailable."}}}},"/need/{needId}":{"get":{"operationId":"bursiaGetNeedIntake","summary":"Read the durable intake record for one need","parameters":[{"name":"needId","in":"path","required":true,"schema":{"type":"string","maxLength":29}}],"responses":{"200":{"description":"Intake record"},"404":{"description":"Need not found"}}}},"/need/schema":{"get":{"operationId":"bursiaNeedSchema","summary":"Read supported candidate outcomes and intake truth boundaries","responses":{"200":{"description":"Need intake schema"}}}},"/x402/verify-mcp":{"post":{"operationId":"bursiaPaidMcpVerify","summary":"Paid read-only MCP verification","description":"Pre-validates a public HTTPS MCP endpoint before issuing x402 v2 payment requirements. Settlement must be confirmed before read-only verification executes. Protocol/schema verification only; not a security certification. Mainnet remains locked until explicit founder authorization and price configuration.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint","protocolVersion"],"properties":{"endpoint":{"type":"string","format":"uri"},"protocolVersion":{"type":"string","enum":["2026-07-28","2025-11-25","2025-06-18"]},"quoteId":{"type":"string"}}}}}},"responses":{"200":{"description":"Settlement confirmed, verification delivered with BURSIA_PAID_MCP_VERIFICATION_RECEIPT_V1."},"400":{"description":"Invalid target/protocol before payment."},"402":{"description":"x402 v2 quote/payment required, or payment not settled."},"403":{"description":"Mainnet route locked pending founder authorization."},"409":{"description":"Quote/payment binding conflict or replay in progress."},"429":{"description":"Target-host precharge limit exceeded."},"502":{"description":"Paid but verification/QA not delivered; human refund review required."}}}},"/x402/test/verify-mcp":{"post":{"operationId":"bursiaPaidMcpVerifyTestnet","summary":"Testnet paid read-only MCP verification","description":"Base Sepolia proof of the paid MCP verification path. Testnet settlement is never revenue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["endpoint","protocolVersion"],"properties":{"endpoint":{"type":"string","format":"uri"},"protocolVersion":{"type":"string","enum":["2026-07-28","2025-11-25","2025-06-18"]},"quoteId":{"type":"string"}}}}}},"responses":{"200":{"description":"Testnet settlement confirmed and bounded verification delivered."},"400":{"description":"Invalid target/protocol before payment."},"402":{"description":"x402 v2 testnet quote/payment required."},"409":{"description":"Quote/payment binding conflict."},"429":{"description":"Target-host precharge limit exceeded."},"502":{"description":"Paid testnet request not delivered."}}}},"/x402/agent-check":{"get":{"operationId":"bursiaAgentCheck","summary":"Paid Burs-IA Agent Check","description":"Returns HTTP 402 with x402 v2 Base-mainnet USDC requirements when unpaid; after successful settlement returns a bounded readiness/payment-path result.","tags":["Agents","Verification","x402"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"agent_ref","in":"query","required":false,"schema":{"type":"string","maxLength":512,"format":"uri"},"description":"Optional public HTTPS Agent Card URL. HTTPS targets are inspected read-only after payment; non-URL references preserve the legacy payment-path check."}],"responses":{"200":{"description":"Paid request accepted and result returned.","content":{"application/json":{"schema":{"type":"object","required":["schema","status","checks","observedAt","coreMutation"],"properties":{"schema":{"type":"string"},"status":{"type":"string"},"agentRef":{"type":"string"},"checks":{"type":"object"},"limitations":{"type":"array","items":{"type":"string"}},"observedAt":{"type":"string","format":"date-time"},"liveMoney":{"type":"boolean"},"coreMutation":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required; read PAYMENT-REQUIRED header and retry with x402 payment."}}}},"/x402/catalog":{"get":{"operationId":"bursiaX402Catalog","summary":"Burs-IA machine-payable service catalog","responses":{"200":{"description":"Catalog"}}}}}}