> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Account Balance

## Account Balances

Your Fluz account can have up to four different balances:

1. **Rewards balance** - A withdrawalable balance that contains your available cashback and bonus rewards.
2. **Cash balance (Spend Account)** - Withdrawable balances that you can use to fund your gift card and virtual card purchases, among other uses.
3. **Fluz prepayment balance** - A non-withdrawable balance you can use towards gift card and virtual card purchases.
4. **Reserve balance** - A balance held in Fluz to cover any transactions that fail to settle, ensuring your account remains in good standing.

In order to see your current balances you can use the `getWallet` [query](https://storage.googleapis.com/fluz-public-docs/api-reference.html#query-getWallet). This can help you determine how much you want to deposit or apply towards a gift card purchase. The sum of these balances makes up your 'available Fluz balance', which determines the total amount you can use towards funding a payment on Fluz.

## User Cash Balance Accounts (Spend Accounts)

You can  access detailed information about individual cash balance accounts through the `userCashBalances` field. Monitoring account status and creation dates

The `userCashBalances` field supports pagination and returns an array of cash balance accounts ordered by creation date (most recent first).

### Sample Response:

```json theme={null}
{
  "data": {
    "getWallet": {
      "bankCards": [BankCard],
      "bankAccounts": [BankAccount],
      "paypalAccounts": [Paypal],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": {
          "availableBalance": "50.00",
          "totalBalance": "50.00",
          "lifetimeBalance": "125.00"
        },
        "cashBalance": {
          "availableBalance": "100.00",
          "totalBalance": "100.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "500.00"
        },
        "giftCardCashBalance": {
          "availableBalance": "25.00",
          "totalBalance": "25.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "75.00"
        },
        "userCashBalances": [
          {
            "userCashBalanceId": "123e4567-e89b-12d3-a456-426614174000",
            "totalCashBalance": "100.00",
            "availableCashBalance": "100.00",
            "lifetimeCashBalance": "500.00",
            "nickname": "Primary Account",
            "status": "ACTIVE",
            "createdAt": "2024-01-15T10:30:00Z"
          },
          {
            "userCashBalanceId": "223e4567-e89b-12d3-a456-426614174001",
            "totalCashBalance": "25.00",
            "availableCashBalance": "25.00",
            "lifetimeCashBalance": "75.00",
            "nickname": "Savings",
            "status": "ACTIVE",
            "createdAt": "2024-02-20T14:15:00Z"
          }
        ]
      }
    }
  }
}
```

### Query with Pagination:

You can paginate through cash balance accounts using the `paginate` parameter:

```graphql theme={null}
query {
  getWallet {
    balances {
      userCashBalances(paginate: { limit: 10, offset: 0 }) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
      }
    }
  }
}
```

### UserCashBalance Fields:

| Field                  | Type                  | Description                                                 |
| ---------------------- | --------------------- | ----------------------------------------------------------- |
| `userCashBalanceId`    | UUID                  | Unique identifier for the user cash balance account         |
| `totalCashBalance`     | String                | Total cash balance in the account                           |
| `availableCashBalance` | String                | Available cash balance that can be used for transactions    |
| `lifetimeCashBalance`  | String                | Cumulative total ever deposited into this account           |
| `nickname`             | String                | Custom nickname for the balance account (optional)          |
| `status`               | UserCashBalanceStatus | Status of the cash balance account (e.g., ACTIVE, INACTIVE) |
| `createdAt`            | DateTime              | Date and time when the account was created                  |

<br />

<StickyContactSalesBanner />