# Loyal Spark Public Programs List

> Loyal Spark Public Programs List is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Retrieves the list of publicly available onchain loyalty reward programs on the Loyal Spark Base L2 protocol

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/public-programs?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-public-programs-list-e5e5a177
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4SV5IMnJk_m2Ra8aK89Hn

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-public-programs-list-e5e5a177
```

Example prompt: Show me all the public loyalty reward programs available on Loyal Spark so I can see which businesses I can earn B20 tokens with.

## When to prefer this

Use this endpoint when an agent or user needs to discover what loyalty programs are publicly available on the Loyal Spark protocol before enrolling, earning, or automating rewards. Prefer this over brand-specific or private program endpoints when the goal is broad discovery of the ecosystem.

## Known failure modes

- Payment not included or insufficient (x402 payment required — 0.001 USDC must accompany request)
- Invalid HTTP method used (only GET, HEAD, DELETE supported)
- No public programs available returns empty list
- Network or gateway timeout from Base L2 RPC latency
- Malformed query parameters result in 400 error

## 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. GET this URL. HTTP 402 for $0.001 USDC on Base, the same price as GET /programs. Payment alone returns active public programs. Do not send an API key. This is not the caller's own program list; for the paying wallet's own programs, call GET /programs (payment alone works there too; an lsk_ key is optional).

## Output

Returns a JSON object with ok: true and a list or metadata about publicly available onchain loyalty programs on the Loyal Spark protocol, including program identifiers and associated B20 token reward 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"
   ],
   "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"
 },
 "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/loyal-spark-public-programs-list-e5e5a177/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)