{"uid":"cap_x18puHk18JdzoY_OXPtG4","slug":"loyal-spark-list-my-vouchers-d0d9551c","name":"Loyal Spark - List My Vouchers","description":"Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.","url":"https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/list_my_vouchers","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","toolName","inputSchema"],"properties":{"type":{"type":"string","const":"mcp"},"example":{"type":"object"},"toolName":{"type":"string"},"transport":{"enum":["streamable-http","sse"],"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_jaTHxPqqehnsbYPnoLhPm","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 all loyalty vouchers held by the authenticated user on the Loyal Spark onchain loyalty protocol running on Base L2.","exampleAgentPrompt":"Can you show me all the loyalty vouchers I currently have on Loyal Spark so I can see what rewards I'm holding and decide which ones to redeem?","exampleUseCases":[{"title":"Check available rewards before checkout","prompt":"I'm about to make a purchase - can you pull up all my Loyal Spark vouchers so I can see if I have any rewards I can use to get a discount?"},{"title":"Track loyalty balance across accounts","prompt":"Show me every loyalty voucher I have on Loyal Spark right now so I can get a complete picture of all my rewards across my accounts."},{"title":"Find high-value rewards for redemption","prompt":"List all my loyalty vouchers on Loyal Spark and help me identify which ones have the highest value so I know what to redeem first."}],"resultDescription":"A JSON list of the authenticated user's loyalty vouchers on the Loyal Spark protocol, including voucher identifiers, associated ERC-20 token details, balances, redemption status, and any relevant metadata about each reward.","failureModes":["Authentication failure — user identity or wallet address not recognized, returns 401/403","No vouchers found — user holds zero vouchers, returns empty array","Network or Base L2 RPC error causing lookup failure","Payment failure — $0.01 USDC x402 payment not processed, returns 402","Rate limiting — too many requests, returns 429"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve a specific user's current loyalty voucher holdings on the Loyal Spark platform on Base L2. Prefer this over generic blockchain balance queries when the user is specifically asking about Loyal Spark vouchers or rewards, and when the agent needs structured voucher metadata rather than raw token balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:08.356Z","isFirstParty":false}