{"uid":"cap_Xco1J5p1j05uCP_aowxlx","slug":"boon-route-reviews-paginated-onchain-review-history-for-x402-endpoints-caf773c1","name":"Boon Route Reviews — Paginated Onchain Review History for x402 Endpoints","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/routes/%7BrouteId%7D/reviews","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["routeId"],"properties":{"routeId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"The routed x402 endpoint ID."}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"reviews":[{"reviewText":"Strong for narrow research queries.","verification":{"reviewerSignature":"valid","reviewerWasTipper":true,"routedRecognition":"verified"}}],"routeId":"0x1212121212121212121212121212121212121212121212121212121212121212","version":"1","pagination":{"limit":25,"total":1,"offset":0,"hasMore":false}}},"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_IwqR-1TEee-6L-MsUT7rT","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":"Retrieves paginated, cryptographically-signed review history for a specific x402 route, including reviewer signatures, USDC-backed recognition signals, and tipper verification status.","exampleAgentPrompt":"Pull up the full review history for x402 route 0x1212121212121212121212121212121212121212121212121212121212121212 — show me the first 25 reviews and let me know which ones have verified tipper signatures and on-chain recognition.","exampleUseCases":[{"title":"Vetting an API before agent use","prompt":"Before my agent starts using that x402 search endpoint, can you fetch the Boon reviews for route 0xabcd...1234 and tell me whether the reviewers were actual tippers with valid signatures?"},{"title":"Comparing endpoint reputations","prompt":"I'm deciding between two x402 routes. Can you get the signed review history for route 0xaaaa...bbbb — up to 50 reviews — so I can see how agents have rated it compared to the other option?"},{"title":"Auditing review credibility for a known route","prompt":"Show me the latest Boon reviews for route 0xdead...beef, especially any where the reviewer's USDC recognition is verified on-chain — I want to make sure the feedback is credible before I recommend this endpoint to my team."}],"resultDescription":"Returns a JSON object containing a paginated array of reviews for the specified x402 route. Each review includes the review text, a reviewer signature validity flag, a boolean indicating whether the reviewer was an actual tipper, and a routed recognition verification status. Also includes route ID, schema version, and pagination metadata (limit, offset, total count, hasMore flag).","failureModes":["Invalid routeId format (must match ^0x[0-9a-fA-F]{64}$) returns a 400 or validation error","Route not found returns empty reviews array or 404","Payment not provided or invalid x402 payment header returns 402 Payment Required","Offset beyond total review count returns empty results with hasMore=false","Limit outside range 1-100 returns a validation error"],"whenToPreferThis":"Use this endpoint when you need the full signed review history for a specific x402 route and want cryptographic verification of reviewer identity and tipper status. Prefer this over free discovery endpoints when the depth and authenticity of review data matters — e.g., before committing an agent to repeatedly call a paid x402 service. The $0.01 USDC cost is justified when review credibility (signature validity, on-chain recognition) is a decision factor.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:44:44.498Z","isFirstParty":false}