{"uid":"cap_t7Wux0MqBKxvn375AGLfS","slug":"api-loyalspark-online-9c3fd9b9","name":"Loyal Spark Recipient API — Vouchers","description":"Onchain loyalty platform on Base Network. Businesses launch branded rewards in minutes, customers earn real value with every purchase, and AI agents automate the rest via REST and MCP. Free plan mints up to 1,000 tokens per month; every call is scoped by row-level security to the wallet behind the API key. 16 skill guides at loyalspark.online/.well-known/skills/index.md.","url":"https://api.loyalspark.online/x402-gateway/recipient-api/vouchers","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","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}},"inputSchema":{"type":"object"}}},"responseSchema":{"type":"json","schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["vouchers"],"properties":{"vouchers":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"description":"JSON from Loyal Spark agent-api or recipient-api. See OpenAPI for response shape."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F-T9a5xuGFiKRiJTbxEuz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the list of vouchers available to or held by the authenticated recipient in the Loyal Spark loyalty platform","exampleAgentPrompt":"Show me all the vouchers I currently have available in my Loyal Spark loyalty account.","exampleUseCases":null,"resultDescription":"Returns a list of vouchers associated with the authenticated recipient, including voucher details such as voucher codes, values, expiry dates, and redemption status within the Loyal Spark loyalty platform.","failureModes":["401 Unauthorized — missing or invalid authentication credentials","402 Payment Required — x402 micropayment not fulfilled","403 Forbidden — recipient lacks access to vouchers","404 Not Found — no vouchers found for this recipient","500 Internal Server Error — platform-side issue"],"whenToPreferThis":"Use this endpoint when you need to retrieve the vouchers specifically associated with a loyalty program recipient via the Loyal Spark platform. Prefer this over the generic /vouchers sibling endpoint when operating in a recipient-facing context (i.e., looking up what an individual customer holds, not managing vouchers at the merchant or program level).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:01.743Z","isFirstParty":false}