---
title: "Changes to Get Customer Balance"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/balance"
---

# Changes to Get Customer Balance

`GET /api/v4.0/integrations/customers/{customerId}/balance`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 41 revisions.

- **2026-02-01** `e7c26fe8697a` — 3 info
- **2025-11-02** `f4bae7aa83d4` — 4 warning, 12 info
- **2025-09-23** `192eb251cada` — 1 info
- **2025-09-10** `2bc98dcabf95` — 1 info
- **2025-09-02** `919eb7a392aa` — 1 breaking

## Changes

- **2026-02-01** `e7c26fe8697a` — 3 info
  - the endpoint scheme security `apiKey AND secretKey` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - the endpoint scheme security `secretKey` was removed from the API
- **2025-11-02** `f4bae7aa83d4` — 4 warning, 12 info
  - removed the optional property `customerId` from the response with the `200` status
  - removed the optional property `pointsBalance` from the response with the `200` status
  - removed the optional property `referrals` from the response with the `200` status
  - removed the optional property `tier` from the response with the `200` status
  - added the optional property `availablePointsBalance` to the response with the `200` status
  - added the optional property `availablePointsValue` to the response with the `200` status
  - added the optional property `currency` to the response with the `200` status
  - added the optional property `nextExpiringPointsAmount` to the response with the `200` status
  - added the optional property `nextExpiringPointsDate` to the response with the `200` status
  - added the optional property `nextExpiringPointsValue` to the response with the `200` status
  - added the optional property `pendingPoints` to the response with the `200` status
  - added the optional property `pendingPointsValue` to the response with the `200` status
  - added the optional property `pointsName` to the response with the `200` status
  - added the optional property `totalEarnedPoints` to the response with the `200` status
  - added the optional property `totalPointsBalance` to the response with the `200` status
  - added the optional property `totalPointsValue` to the response with the `200` status
- **2025-09-23** `192eb251cada` — 1 info
  - api operation id `getCustomerBalance` was added
- **2025-09-10** `2bc98dcabf95` — 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/gameballers/apis/gameball-api/docs/api/v4.0/integrations/customers/:customerId/balance/get.md) · [API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [Page](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/balance/get)