# Loyal Spark - List My Vouchers

> Loyal Spark - List My Vouchers is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves all loyalty vouchers held by the authenticated user on the Loyal Spark onchain loyalty protocol running on Base L2.

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/list_my_vouchers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-list-my-vouchers-d0d9551c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x18puHk18JdzoY_OXPtG4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability loyal-spark-list-my-vouchers-d0d9551c -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-list-my-vouchers-d0d9551c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.loyalspark.online](https://www.zero.xyz/host/api.loyalspark.online/llms.txt)