# Loyal Spark Recipient API — Offers

> Loyal Spark Recipient API — Offers 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-15).

Retrieves available loyalty offers accessible to a recipient via the Loyal Spark platform

## Facts

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

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-33ddddb9
```

Example prompt: Can you check what loyalty offers are currently available to me on Loyal Spark and list any promotions or deals I can redeem?

## When to prefer this

Use this endpoint when you need to retrieve the list of offers available to a specific loyalty program recipient on the Loyal Spark platform. Prefer this over the general 'offers' sibling endpoint when you need recipient-scoped or personalized offer data rather than a global offers list.

## Known failure modes

- 401/402 Unauthorized — missing or invalid payment/auth header
- 404 Not Found — no offers available for the recipient
- 500 Internal Server Error — upstream service error
- Empty array returned — recipient has no active offers
- Rate limiting or quota exceeded

## 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 accessible to the authenticated recipient, likely including offer details such as offer ID, name, description, discount or reward value, validity period, 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-33ddddb9/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)