# Loyal Spark Recipient Rewards API

> Loyal Spark Recipient Rewards API 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 rewards available or earned for a recipient in the Loyal Spark loyalty platform

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/recipient-api/rewards
- 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-296630af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hlFyIw_PvR2eswaM7qu4I

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-296630af
```

Example prompt: Can you pull up the rewards for my account from Loyal Spark so I can see what loyalty rewards I've earned?

## When to prefer this

Use this endpoint when you need to retrieve the rewards (not balances or vouchers) associated with a specific recipient in the Loyal Spark loyalty platform. Prefer this over the general /rewards endpoint when operating in a recipient-scoped context. Use /recipient-api/balances or /recipient-api/vouchers for balance or voucher data respectively.

## Known failure modes

- 401 Unauthorized — missing or invalid payment/auth credentials
- 402 Payment Required — x402 micropayment not completed
- 404 Not Found — recipient not found or no rewards exist
- 500 Internal Server Error — upstream service failure
- Empty list returned if recipient has no rewards

## 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

A list of rewards associated with the authenticated recipient, including reward details such as names, values, statuses, and any relevant metadata about each reward in the loyalty program.

## 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": [
   "rewards"
  ],
  "properties": {
   "rewards": {
    "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-296630af/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)