---
title: "Changes to List credit balances for a customer"
method: GET
path: "/customers/{customer_id}/credit-balances"
---

# Changes to List credit balances for a customer

`GET /customers/{customer_id}/credit-balances`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 19 revisions.

- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking, 2 warning
- **2026-02-02** (v1) `9ba8be0f2006`: 11 breaking, 4 warning, 41 info
- **2025-02-03** (v1) `50bbef23e6a1`: 2 info
- **2024-12-06** (v1) `274e5b2be190`: 1 warning, 1 info
- **2024-02-19** (v1) `a4a4068ff792`: 1 warning, 3 info

## Changes

- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking, 2 warning
  - added the pattern `^ctm_[a-z\d]{26}$` to the `path` request parameter `customer_id`
  - added the new `CLP` enum value to the `data/items/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
- **2026-02-02** (v1) `9ba8be0f2006`: 11 breaking, 4 warning, 41 info
  - added the new path request parameter `customer_id`
  - the `data/items/currency_code` response property's maxLength was unset from `3` for the response status `200`
  - the `data/items/currency_code` response property's minLength was decreased from `3` to `0` for the response status `200`
  - the `data/items/balance` response's property type changed from `object` to no type for status `200`
  - the `data/items/currency_code` response's property type changed from `string` to no type for status `200`
  - the `data/items/customer_id` response's property type changed from `string` to no type for status `200`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `error/code` from the response with the `default` status
  - removed the required property `error/detail` from the response with the `default` status
  - removed the required property `error/documentation_url` from the response with the `default` status
  - removed the required property `error/type` from the response with the `default` status
  - removed the optional property `data/items/balance/available` from the response with the `200` status
  - removed the optional property `data/items/balance/reserved` from the response with the `200` status
  - removed the optional property `data/items/balance/used` from the response with the `200` status
  - removed the optional property `error/errors` from the response with the `default` status
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - added `#/components/schemas/CurrencyCode` to the `data/items/currency_code` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CustomerBalance` to the `data/items/balance` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CustomerId` to the `data/items/customer_id` response property `allOf` list for the response status `200`
  - the response property `data/items/balance` became required for the status `200`
  - the response property `data/items/currency_code` became required for the status `200`
  - the response property `data/items/customer_id` became required for the status `200`
  - the response property `error` became required for the status `default`
  - the response property `meta` became required for the status `default`
  - removed the `ARS` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `AUD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `BRL` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CAD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CHF` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CNY` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `COP` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CZK` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `DKK` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `EUR` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `GBP` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `HKD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `HUF` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `ILS` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `INR` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `JPY` enum value from the `data/items/currency_code` response property for the response status `200`
  - …16 more
- **2025-02-03** (v1) `50bbef23e6a1`: 2 info
  - api tag `Customers` added
  - api tag `Adjustments` removed
- **2024-12-06** (v1) `274e5b2be190`: 1 warning, 1 info
  - added the new `VND` enum value to the `data/items/currency_code` response property for the response status `200`
  - added the new optional `query` request parameter `currency_code`
- **2024-02-19** (v1) `a4a4068ff792`: 1 warning, 3 info
  - deleted the `query` request parameter `currency_code`
  - api tag `Customers` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/customers/:customer_id/credit-balances/get.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/customers/:customer_id/credit-balances/get)
