Skip to content
RewardOSRewardOS Docs

Wallet

Balance

Section titled “Balance”

GET /b2b/wallet/balance

Terminal window
curl "$REWARDOS_API_BASE/b2b/wallet/balance" \
  -H "x-api-key: $REWARDOS_API_KEY"
{
  "balance": {
    "walletAccountId": "9b2d5e05-1a1b-4288-80ab-548fea5cd3db",
    "currency": "INR",
    "posted": 10000,
    "held": 0,
    "available": 10000
  }
}

posted records settled ledger value, held is reserved for in-flight work, and available is the amount currently usable for purchases. Do not calculate or persist your own balance from purchase responses.

Ledger

Section titled “Ledger”

GET /b2b/wallet/ledger returns append-only entries for the authenticated tenant.

Terminal window
curl "$REWARDOS_API_BASE/b2b/wallet/ledger" \
  -H "x-api-key: $REWARDOS_API_KEY"

Each entry includes its entryType (credit or debit), amount, currency, reason, and timestamp. Contact RewardOS support to arrange a top-up; there is no partner self-service top-up API.