{"uid":"cap_YOYtIyIDm3jUiuxPbi2ie","slug":"boon-receipt-verified-endpoint-review-submission-c132602a","name":"Boon Receipt-Verified Endpoint Review Submission","description":"Boon is the gratuity graph for agents. Discover recognized x402 endpoints for free, compare signed reviews with USDC recognition and $BOON burned, then pay one cent through x402 or MPP only for full review history.","url":"https://api.boonprotocol.com/api/v1/x402/reviews/receipt-verified","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"review":{"type":"object","required":["version","policyVersion","routeId","receiptDigest","reviewText","createdAt"],"properties":{"routeId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"version":{"enum":["2"],"type":"string"},"createdAt":{"type":"integer","minimum":0},"reviewText":{"type":"string","maxLength":1000,"minLength":1,"x-max-utf8-bytes":1000},"policyVersion":{"enum":["boon.x402-review-policy/v2"],"type":"string"},"receiptDigest":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"additionalProperties":false},"evidence":{"type":"object","required":["offer","receipt"],"properties":{"offer":{"type":"object","required":["format","payload","signature"],"properties":{"format":{"enum":["eip712"],"type":"string"},"payload":{"type":"object","required":["version","resourceUrl","scheme","network","asset","payTo","amount","validUntil"],"properties":{"asset":{"type":"string","maxLength":256,"minLength":1},"payTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"amount":{"type":"string","pattern":"^[1-9][0-9]*$","maxLength":78},"scheme":{"type":"string","maxLength":64,"minLength":1},"network":{"enum":["eip155:8453"],"type":"string"},"version":{"enum":[1],"type":"integer"},"validUntil":{"type":"integer","minimum":1},"resourceUrl":{"type":"string","format":"uri","maxLength":4096}},"additionalProperties":false},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]{130}$"},"acceptIndex":{"type":"integer","minimum":0}},"additionalProperties":false},"receipt":{"type":"object","required":["format","payload","signature"],"properties":{"format":{"enum":["eip712"],"type":"string"},"payload":{"type":"object","required":["version","network","resourceUrl","payer","issuedAt"],"properties":{"payer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"network":{"enum":["eip155:8453"],"type":"string"},"version":{"enum":[1],"type":"integer"},"issuedAt":{"type":"integer","minimum":1},"resourceUrl":{"type":"string","format":"uri","maxLength":4096},"transaction":{"type":"string","pattern":"^(?:|0x[0-9a-fA-F]{64})$"}},"additionalProperties":false},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]{130}$"}},"additionalProperties":false}},"additionalProperties":false},"signature":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2})+$","maxLength":8194,"description":"65-byte EOA signature by the receipt payer. ERC-1271 contract signatures are accepted by the runtime and may use their contract-defined byte length."}}},"responseSchema":{"type":"json","example":{"review":{"reviewText":"Useful for a narrow query.","evidenceKind":"receipt_verified"},"routeId":"0x1212121212121212121212121212121212121212121212121212121212121212","version":"2"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B9h6A259myJEyK0C7ld1l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a cryptographically receipt-verified review of an x402 API endpoint, backed by proof of actual payment on Base network","exampleAgentPrompt":"Submit a receipt-verified review on Boon for the x402 endpoint with route ID 0x1212...1212 — I just paid for it and here's my signed offer and payment receipt from Base network — my review text is: 'Useful for a narrow query, responded quickly.'","exampleUseCases":[{"title":"Verified feedback after API usage","prompt":"I just paid for an x402 endpoint on Base and want to leave a receipt-verified review on Boon — the route ID is 0xabc...def, my signed offer and receipt are ready, and my review is: 'Accurate results, fast response, worth the cent.'"},{"title":"Building trust signal for API marketplace","prompt":"I'm an agent that just used a paid x402 API — post a verified Boon review using my payment receipt to prove I actually called the endpoint, so other agents can see credible usage feedback. Route is 0x9f8...321, review: 'Reliable geocoding, no errors in 10 calls.'"},{"title":"Attesting quality of a newly discovered endpoint","prompt":"I found a new x402 endpoint via Boon, paid for it, and it worked great — submit a receipt-verified review for route 0x5e7...aa1 on Boon with my EIP-712 signed offer and receipt proving I paid, review text: 'Excellent uptime, schema matched docs perfectly.'"}],"resultDescription":"A JSON object confirming the stored review, including the route ID, review text, version string, and evidence kind labeled as 'receipt_verified', confirming the review was accepted and linked to cryptographic proof of payment.","failureModes":["Invalid or malformed receiptDigest (must match 0x + 64 hex chars)","Receipt signature fails EIP-712 verification on Base (eip155:8453)","Offer or receipt payload missing required fields (version, resourceUrl, payer, etc.)","Review text exceeds 1000 bytes UTF-8 limit","Wrong policyVersion (must be boon.x402-review-policy/v2)","Payment not confirmed or receipt not recognized as valid for the given route","routeId format mismatch (must be 0x + 64 hex chars)","Duplicate review submission for the same receipt digest"],"whenToPreferThis":"Use this endpoint when you want to publish a receipt-verified review of an x402 API endpoint — i.e. you have actual cryptographic proof (EIP-712 signed offer + receipt) of a USDC payment on Base network (eip155:8453). This is the highest-credibility review type on Boon, as it requires demonstrable payment evidence. Prefer this over self-reported reviews when you want your review to carry weight in Boon's gratuity graph and be distinguishable from unverified opinions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:48:00.235Z","isFirstParty":false}