---
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 (mils)
  - `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

---

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