# Loyal Spark API — Programs

> Loyal Spark API — Programs 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 loyalty programs available on the Loyal Spark platform

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/programs
- 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-9e471e37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hVOiP7TQ-8spb5gustegG

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-9e471e37
```

Example prompt: Can you pull the full list of loyalty programs available on Loyal Spark so I can see which ones are active and configure my rewards setup?

## When to prefer this

Use this endpoint when you need to discover or enumerate all loyalty programs available on the Loyal Spark platform, such as before fetching rewards, offers, or customer balances tied to a specific program. Prefer this over sibling endpoints when the goal is program-level discovery rather than individual customer or reward data.

## Known failure modes

- 401/402 Unauthorized — missing or invalid payment/auth header
- 404 Not Found — endpoint path incorrect or no programs configured
- 500 Internal Server Error — upstream platform issue
- Empty list — no programs have been created yet
- Rate limiting or payment failure due to insufficient USDC balance

## 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 loyalty programs configured on the Loyal Spark platform, including program details such as names, types, and configuration metadata.

## 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/api-loyalspark-online-9e471e37/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)