{"uid":"cap_EMteURq7qHU7ZptMp6sQH","slug":"boon-protocol-per-handle-boon-list-3d88f147","name":"Boon Protocol Per-Handle Boon List","description":"Boon chronological per-handle boon list","url":"https://api.boonprotocol.com/api/v1/handles/github:velinussage/boons","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":["handle"],"properties":{"handle":{"type":"string","description":"GitHub handle, x:name, or agent:N ERC-8004 identity"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_nJKHhiHn2oQM4ifnnsRE-","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 a chronological list of boons (recognitions/gratuities) received by a specific GitHub, X, or agent identity handle","exampleAgentPrompt":"Can you pull up the list of boons that github:velinussage has received on Boon Protocol, showing the most recent 50?","exampleUseCases":null,"resultDescription":"A chronological list of boon events for the requested handle, including recognition records such as sender identity, timestamp, amount, and associated endpoint or context. Returns up to the requested limit (default 50, max 200).","failureModes":["Handle not found — returns empty list or 404 if the identity has no boon records","Invalid handle format — error if the handle does not conform to github:name, x:name, or agent:N formats","Limit out of range — error if limit is below 1 or above 200","Payment failure — x402 payment of $0.01 USDC required; missing or invalid payment returns 402","Network timeout — service unavailable responses under load"],"whenToPreferThis":"Use this endpoint when you need the full chronological boon/recognition history for a specific identity handle (GitHub, X, or ERC-8004 agent). Prefer this over the batch gratitude graph query when you need per-handle detail and timeline ordering rather than aggregate graph data. Choose this when building reputation dashboards, auditing recognition history, or verifying how much gratitude a specific developer or endpoint creator has received.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:16.554Z","isFirstParty":false}