# Loyal Spark Offers API

> Loyal Spark Offers API 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 available loyalty offers from the Loyal Spark platform via the x402-gateway

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/offers
- 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-2342484c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TUnyVglLm54kZlptL9-AX

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-2342484c
```

Example prompt: Can you pull up all the currently available loyalty offers on Loyal Spark so I can see what promotions are active right now?

## When to prefer this

Use this endpoint when you need to list or browse all currently available loyalty offers from the Loyal Spark platform, especially within an agentic workflow that needs to discover promotions before redeeming, distributing, or displaying them to customers. Prefer this over the recipient-api/offers endpoint when acting as an operator/admin rather than a loyalty program recipient.

## Known failure modes

- 401/402 Unauthorized — missing or invalid payment header (requires $0.001 USDC via x402 protocol)
- 404 Not Found — no offers currently available or endpoint path incorrect
- 500 Internal Server Error — upstream Loyal Spark service unavailable
- Empty response — no active offers exist at query time
- Rate limiting — too many requests in short window

## 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

A list of available loyalty offers from the Loyal Spark platform, likely including offer details such as offer IDs, descriptions, discount values, validity periods, and eligibility criteria.

## 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": [
   "offers"
  ],
  "properties": {
   "offers": {
    "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-2342484c/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)