# Loyal Spark - Lookup Gift Certificate

> Loyal Spark - Lookup Gift Certificate is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Looks up the details and status of a gift certificate on the Loyal Spark onchain loyalty protocol running on Base L2.

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/lookup_gift_certificate
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-lookup-gift-certificate-f95492b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4QJpN6V9r4fY3NAThGWlT

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-lookup-gift-certificate-f95492b5 -d '<json body>'
```

Example prompt: Can you look up the gift certificate with code GC-8473-SPARK on Loyal Spark and tell me if it's still valid, how much it's worth, and whether it's been redeemed yet?

## When to prefer this

Use this endpoint when an agent or user needs to check the existence, validity, value, or redemption status of a specific gift certificate on the Loyal Spark onchain loyalty protocol on Base L2. Prefer this over generic blockchain explorers when you want structured, application-layer data about a gift certificate rather than raw transaction data.

## Known failure modes

- Gift certificate ID or code not found — returns 404 or empty result
- Invalid input format for certificate code — returns 400 validation error
- Certificate belongs to a different program or chain — returns mismatch error
- Payment of $0.01 USDC not provided or rejected — returns 402 payment required
- Onchain RPC node unavailable — returns 503 service unavailable
- Rate limiting exceeded — returns 429 too many requests

## How this service works

Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.

## Output

Returns JSON containing the gift certificate's details such as its current status (active, redeemed, expired), token value, issuing loyalty program, recipient address, and any relevant expiration or redemption metadata stored onchain on Base L2.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "example": {
     "type": "object"
    },
    "toolName": {
     "type": "string"
    },
    "transport": {
     "enum": [
      "streamable-http",
      "sse"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-lookup-gift-certificate-f95492b5/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)