---
title: "CustomerBalances (Chargebee)"
description: "Customer Balances"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/chargebee/Chargebee.Customers.CustomerBalances
original: https://documentation.invantive.eu/en/datamodels/chargebee/Chargebee.Customers.CustomerBalances
updated: 2024-06-10T18:44:26Z
license: https://documentation.invantive.eu/en/
---

# CustomerBalances: Chargebee Customer Balances

`read only` `REST`

- Catalog: `Chargebee`
- Schema: `Customers`
- Primary Keys: `id`
- Label: Customer Balances

Can only retrieve data.

## API Source

- Endpoint: `/customers`

## Table Columns

The columns of the table `CustomerBalances` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `currency_code` | `varchar2(3)` | Currency Code | [ ] |  | The currency code (ISO 4217 format) for balance. |
| `customer_id` | `varchar2` | Customer ID | [x] |  |  |
| `excess_payments` | `decimal` | Excess Payments | [ ] |  | Total unused payments associated with the customer. |
| `promotional_credits` | `decimal` | Promotional Credits | [ ] |  | Promotional credits balance of this customer. |
| `refundable_credits` | `decimal` | Refundable Credits | [ ] |  | Refundable credits balance of this customer. |
| `unbilled_charges` | `decimal` | Unbilled Charges | [ ] |  | Total unbilled charges for this customer. |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Chargebee](/en/release-notes/drivers?driver=chargebee)

