# Loyal Spark Recipient API - Balances

> Loyal Spark Recipient API - Balances 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-14).

Retrieves all loyalty point/reward balances across programs for a recipient via the Loyal Spark platform

## Facts

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

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-cdd40c76
```

Example prompt: Can you check all the current loyalty reward balances for my account on Loyal Spark and show me what points or credits I have across the programs I'm enrolled in?

## When to prefer this

Use this endpoint when you need to retrieve all balances for a loyalty recipient in one call, rather than checking a single program balance. Prefer this over the singular /balance endpoint when a complete multi-program overview is needed.

## Known failure modes

- 401 Unauthorized if authentication headers are missing or invalid
- 404 Not Found if the recipient does not exist
- 402 Payment Required if the $0.001 USDC micropayment via x402 is not completed
- 500 Internal Server Error if the Loyal Spark backend is unavailable
- Empty balance list if the recipient has no active program enrollments

## 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 balance records for the recipient, including points totals and reward amounts per loyalty program they are enrolled in.

## 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": [
   "balances"
  ],
  "properties": {
   "balances": {
    "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-cdd40c76/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)