v1 · Rewards wallet · no stored money

Wallet API

Show your users the coupons they have won: ready to use, used and expired.

The rewards wallet is a list of a user’s coupons. It holds no money and no points: coupons are free rewards with no cash value.

Use it to build a “My rewards” screen in your app. Only coupons your account issued are returned, keyed by the userRef you sent when issuing.

Users who chose to save coupons to Eligify (customer.consent) also see them in their Eligify account at eligify.in.

Authentication

Same partner API key as the Voucher API.

• Authorization

  Bearer elg_pk_<prefix>_<secret>: your partner API key (issued by Eligify, shown once)

const res = await fetch(`https://eligify.in/api/v1/wallets/${encodeURIComponent(user.id)}?status=ACTIVE`, {
  headers: { Authorization: `Bearer ${process.env.ELIGIFY_API_KEY}` },
});
const { data } = await res.json();
// data.summary → { active, redeemed, expired }; data.coupons → list

• Shares the 6,000 requests per hour limit with the Voucher API.
• Cache results for a minute or two rather than calling on every screen render.

Get a user’s coupons

Up to 200 coupons, newest first. Filter with `?status=ACTIVE|REDEEMED|EXPIRED`. Voided coupons are never returned.

GET /api/v1/wallets/user_48213?status=ACTIVE

{
  "success": true,
  "data": {
    "userRef": "user_48213",
    "summary": {
      "active": 2,
      "redeemed": 5,
      "expired": 1
    },
    "coupons": [
      {
        "code": "K7QM-4XPA",
        "status": "ACTIVE",
        "url": "https://eligify.in/c/K7QM-4XPA",
        "store": "Brew Street Cafe",
        "title": "Weekend coffee treat",
        "offer": "₹100 off on bills of ₹500 or more",
        "expiresAt": "2026-10-26T10:15:00.000Z"
      }
    ]
  }
}

Good practice

Compliance

• Not a payment wallet

  Nothing in the rewards wallet can be spent like money, transferred or withdrawn. Present it as a list of rewards, never as a balance.