{"openapi":"3.1.0","info":{"title":"PayeeProof API","version":"0.1.0","description":"Payment identity intelligence for AI agents. A consistent result verifies public machine-readable consistency only; it does not authorize spending or verify legal identity."},"servers":[{"url":"https://payeeproof.davisvillelabs.com"}],"paths":{"/v1/payee/check":{"post":{"operationId":"payeeproof.check_payee","summary":"Check payee consistency","description":"Paid $0.01 deterministic consistency assessment for a public machine-payment endpoint. Eligibility is checked before PayeeProof payment. The service never forwards target payment credentials.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["target_url"],"additionalProperties":false,"properties":{"target_url":{"type":"string","format":"uri","description":"Public HTTPS target URL. Default HTTPS port only."},"request_method":{"type":"string","enum":["GET","HEAD","POST","PUT","PATCH","DELETE"],"default":"GET"},"operation":{"type":"string","maxLength":160},"expected_service_name":{"type":"string","maxLength":160},"expected_domain":{"type":"string"},"expected_protocol":{"type":"string","enum":["x402","mpp"]},"expected_price_cents":{"type":"integer","minimum":1},"expected_currency":{"type":"string"},"expected_network":{"type":"string"},"expected_asset":{"type":"string"},"expected_pay_to":{"type":"string"},"live_probe":{"type":"boolean"},"observed_response":{"type":"object","additionalProperties":false,"properties":{"http_status":{"type":"integer","minimum":100,"maximum":599},"payment_required":{"type":"string"},"www_authenticate":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"content_location":{"type":"string"},"observed_at":{"type":"string","format":"date-time"}}}}}}}},"responses":{"200":{"description":"Paid assessment delivered","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","checkedAt","assessment","target","claimedIdentity","observedIdentity","normalizedPaymentFacts","checks","historicalContinuity","evidence","limitations","recommendedMachineNextStep","deterministicDigest"],"properties":{"schemaVersion":{"const":"payeeproof-check.v1"},"checkedAt":{"type":"string","format":"date-time"},"assessment":{"enum":["consistent","review_required","conflict"]},"target":{"type":"object"},"claimedIdentity":{"type":"object"},"observedIdentity":{"type":"object"},"normalizedPaymentFacts":{"type":"object"},"checks":{"type":"array","items":{"type":"object","required":["id","status","summary"],"properties":{"id":{"type":"string"},"status":{"enum":["pass","warn","fail","unknown"]},"summary":{"type":"string"},"evidence":{"type":"array"}}}},"historicalContinuity":{"type":"object"},"evidence":{"type":"array"},"limitations":{"type":"array","items":{"type":"string"}},"recommendedMachineNextStep":{"type":"object"},"deterministicDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"additionalProperties":true}}}},"402":{"description":"PayeeProof stablecoin payment required"},"422":{"description":"Unsafe, unsupported, or insufficient target evidence"}},"x-payment-info":{"priceCents":1,"currency":"USD","preference":"stablecoin-first","methods":{"tempo":{"protocol":"MPP","method":"tempo","intents":["charge"],"network":"tempo","asset":"USDC.e","preferred":true}}}}}},"components":{"schemas":{"PayeeCheckInput":{"type":"object","required":["target_url"],"additionalProperties":false,"properties":{"target_url":{"type":"string","format":"uri","description":"Public HTTPS target URL. Default HTTPS port only."},"request_method":{"type":"string","enum":["GET","HEAD","POST","PUT","PATCH","DELETE"],"default":"GET"},"operation":{"type":"string","maxLength":160},"expected_service_name":{"type":"string","maxLength":160},"expected_domain":{"type":"string"},"expected_protocol":{"type":"string","enum":["x402","mpp"]},"expected_price_cents":{"type":"integer","minimum":1},"expected_currency":{"type":"string"},"expected_network":{"type":"string"},"expected_asset":{"type":"string"},"expected_pay_to":{"type":"string"},"live_probe":{"type":"boolean"},"observed_response":{"type":"object","additionalProperties":false,"properties":{"http_status":{"type":"integer","minimum":100,"maximum":599},"payment_required":{"type":"string"},"www_authenticate":{"type":"string"},"location":{"type":"string"},"link":{"type":"string"},"content_location":{"type":"string"},"observed_at":{"type":"string","format":"date-time"}}}}},"PayeeCheckResult":{"type":"object","required":["schemaVersion","checkedAt","assessment","target","claimedIdentity","observedIdentity","normalizedPaymentFacts","checks","historicalContinuity","evidence","limitations","recommendedMachineNextStep","deterministicDigest"],"properties":{"schemaVersion":{"const":"payeeproof-check.v1"},"checkedAt":{"type":"string","format":"date-time"},"assessment":{"enum":["consistent","review_required","conflict"]},"target":{"type":"object"},"claimedIdentity":{"type":"object"},"observedIdentity":{"type":"object"},"normalizedPaymentFacts":{"type":"object"},"checks":{"type":"array","items":{"type":"object","required":["id","status","summary"],"properties":{"id":{"type":"string"},"status":{"enum":["pass","warn","fail","unknown"]},"summary":{"type":"string"},"evidence":{"type":"array"}}}},"historicalContinuity":{"type":"object"},"evidence":{"type":"array"},"limitations":{"type":"array","items":{"type":"string"}},"recommendedMachineNextStep":{"type":"object"},"deterministicDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"additionalProperties":true}}}}