Status: Stable.

Members: Get Points Balance

Use this endpoint to read the current points state for a member.

Endpoint

GET /api/v1/members/{externalMemberId}/balance

Club Key

The API key identifies the club. Do not add clubId to the URL.

Request

curl https://api.more-rewards.co.uk/api/v1/members/member_external_id/balance \
  -H "X-MR-Key-Id: club_live_example" \
  -H "X-MR-Timestamp: 2026-03-25T09:10:00Z" \
  -H "X-MR-Signature: v1=<computed_signature>"

Success response

{
  "ok": true,
  "data": {
    "partnerRef": "club_public_id",
    "externalMemberId": "member_external_id",
    "currency": "GBP",
    "balances": {
      "pointsBalance": 3400,
      "reservedPointsBalance": 200
    },
    "totals": {
      "lifetimePointsAwarded": 5400,
      "lifetimePointsRedeemed": 2000
    },
    "redemption": {
      "rateMinorPerPoint": 1
    },
    "updatedAt": "2026-03-25T09:08:33.000Z"
  }
}

Response fields

pointsBalance: available points
reservedPointsBalance: points reserved for in-flight redemptions
lifetimePointsAwarded: cumulative awarded points
lifetimePointsRedeemed: cumulative redeemed points
rateMinorPerPoint: current redemption conversion rate for the club

Redeem Points