---
title: "Get customer credit balance"
method: GET
path: "/v1/sdk/customers/{reference}/balance"
tags: ["Customers"]
---

# Get customer credit balance

`GET /v1/sdk/customers/{reference}/balance`

Returns the credit balance for a customer identified by reference.

## Path parameters

- `reference` string, required

## Response `200`

Customer balance retrieved successfully

- CustomerBalanceResponse
  - `credits` number, required — Raw credit balance in credits (100 credits = 1 minor currency unit)
  - `creditsPerMinorUnit` number, required — Number of credits per minor currency unit
  - `customerRef` string, required — Customer reference identifier
  - `display` CustomerBalanceDisplayDto, required
    - `amountMajor` number, required — Balance amount in the display currency major units (e.g. dollars)
    - `currency` string, required — ISO 4217 display currency code
    - `exchangeRate` number, required — Exchange rate applied from USD to the display currency
    - `formatted` string, required — Human-readable formatted balance
    - `rateSource` 'parity' | 'db' | 'fallback', required — Source of the exchange rate used
  - `displayCurrency` string, required — ISO 4217 display currency code
  - `displayExchangeRate` number, required — Exchange rate from USD to the display currency

## Other responses

- `404` — Customer not found

## Changes

- **2026-07-04** `a30b6aef464d` — 1 breaking, 6 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `credits` to the response with the `200` status
  - added the required property `creditsPerMinorUnit` to the response with the `200` status
  - added the required property `customerRef` to the response with the `200` status
  - …3 more
- **2026-04-26** `60c2cd1caf83` — 2 breaking
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `404`
- **2026-04-10** `c6f97c4a5492` — 2 breaking
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `404`
- **2026-04-09** `7b327a22e3cb` — 1 warning
  - deleted the `query` request parameter `currency`
- **2026-04-08** `052cc028fdfa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/customers/:reference/balance/get.md)

---

[API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.dev/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/revisions/d29ab7373802/schema)