# Loyal Spark API — Customers

> Loyal Spark API — Customers is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Retrieves the list of customers enrolled in the Loyal Spark loyalty platform

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/customers
- Price: $0.002/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-9e4e9b8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zu-0D3BLNtYFTN1buRbNH

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

Example prompt: Can you pull up the full list of customers enrolled in our Loyal Spark loyalty program so I can see who's participating?

## When to prefer this

Use this endpoint when you need to retrieve the roster of customers participating in the Loyal Spark loyalty program, particularly for admin or merchant-side operations. Prefer this over recipient-api endpoints when you need the full customer list rather than a single recipient's balance or vouchers.

## Known failure modes

- 401/402 Unauthorized — missing or invalid payment credentials
- 404 Not Found — endpoint unavailable or program not found
- 500 Internal Server Error — platform-side issue
- Empty result set if no customers are enrolled
- Rate limiting if too many requests are made in quick succession

## 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 customer records enrolled in the Loyal Spark loyalty platform, likely including customer identifiers, membership details, and associated loyalty program data.

## 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-9e4e9b8c/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)