# Loyal Spark Recipient API — Vouchers

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

Retrieves the list of vouchers available to or held by the authenticated recipient in the Loyal Spark loyalty platform

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/recipient-api/vouchers
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-loyalspark-online-9c3fd9b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t7Wux0MqBKxvn375AGLfS

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 api-loyalspark-online-9c3fd9b9
```

Example prompt: Show me all the vouchers I currently have available in my Loyal Spark loyalty account.

## When to prefer this

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).

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-loyalspark-online-9c3fd9b9/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)