# Loyal Spark Redeem Reward

> Loyal Spark Redeem Reward 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-16).

Redeems loyalty reward tokens on the Loyal Spark onchain platform (Base Network) on behalf of a customer or AI agent

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/redeem-reward
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-redeem-reward-794dd626
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ShNNwOOr4QeCixlYQoHtI

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-redeem-reward-794dd626 -d '<json body>'
```

Example prompt: Redeem my accumulated Loyal Spark reward tokens for Morning Bloom Coffee Shop — submit a POST redemption request using my wallet address so the discount is applied to my current purchase.

## When to prefer this

Use this endpoint when an AI agent or customer needs to actually spend/redeem accumulated loyalty tokens on the Loyal Spark platform running on Base L2. Prefer this over earn or query endpoints when the intent is to consume rewards for value. Ideal for agentic checkout flows where the agent automates the final redemption step.

## Known failure modes

- Insufficient loyalty token balance — redemption rejected
- Invalid or missing required body fields — 400 validation error
- Reward program not active or expired — redemption denied
- Payment of $0.01 USDC not received — 402 Payment Required
- Onchain transaction failure on Base Network — partial or failed state
- Malformed request body type (must be json/form-data/text) — schema error

## How this service works

Onchain loyalty platform on Base Network. Businesses launch branded rewards in minutes. Customers earn real value with every purchase. AI agents automate the rest.

## Output

A JSON response from the Loyal Spark agent-api or recipient-api confirming the redemption outcome, including transaction status, reward amount redeemed, and any onchain transaction reference. Shape varies — see OpenAPI spec for full details.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "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",
 "example": {
  "ok": true,
  "resource": "redeem-reward"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-redeem-reward-794dd626/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)