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

# Get Balance Details V2

> There are 5 balance types:
  - `available_balance`: The balance available for all transactions.
  - `incoming_balance`: The balance shows successful payments but the 3rd party device has not yet paid for it (payment card).
  - `outgoing_balance`: The balance being transferred is waiting to be taken from the available balance to process actions (refund, dispute, payout).
  - `rolling_reserve_balance`: The floating amount a merchant keeps in their balance. Rolling reserve balance is not mandatory. The merchant can request to reserve balance by contacting tech support.
  - `withdrawable_balance`: The amount you can withdraw excludes rolling reserves.



## OpenAPI

````yaml /api/openapi/v2-reference.yaml get /v2/balances/detail
openapi: 3.0.2
info:
  title: Multi-currency Payment APIs
  description: >-
    ## Introduction

    The Multi-currency Payment API Solution provides developers with a unified
    API schema to support multiple currencies efficiently. These APIs enable
    seamless transactions for both payin and payout operations, ensuring a
    robust, reliable, and scalable payment infrastructure for businesses dealing
    with various currencies.

    ### Key Features

    - **Single API Schema**: A single schema supports all currencies in your
    account, simplifying integration and management.

    - **Payin and Payout Process**:
      - **Step 1**: Call the **Get payin method list** to retrieve the list of supported methods.
      - **Step 2**: Call the **Get payin required fields** to get specific required fields for each method.
      - **Step 3**: Create the payment using the method and required fields from the previous step.
      - **Step 4**: On the sandbox environment, you can call the **Simulate payin** to simulate the payment.

    <div class="gst-note-red">
      Please note: GST should only be set to <code>true</code> for AU Merchants for <b>AUD</b> currency only. For all other currencies, set GST to <code>false</code>.
    </div>

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  version: 2.0.0
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security:
  - app-id: []
    secret-key: []
paths:
  /v2/balances/detail:
    get:
      tags:
        - Balance
      summary: Get Balance Details V2
      description: |-
        There are 5 balance types:
          - `available_balance`: The balance available for all transactions.
          - `incoming_balance`: The balance shows successful payments but the 3rd party device has not yet paid for it (payment card).
          - `outgoing_balance`: The balance being transferred is waiting to be taken from the available balance to process actions (refund, dispute, payout).
          - `rolling_reserve_balance`: The floating amount a merchant keeps in their balance. Rolling reserve balance is not mandatory. The merchant can request to reserve balance by contacting tech support.
          - `withdrawable_balance`: The amount you can withdraw excludes rolling reserves.
      operationId: getBalanceDetail
      parameters:
        - name: currency
          in: query
          description: >-
            The currency of the balance. If not provided, the default currency
            will be 'AUD'
          schema:
            type: string
            enum:
              - AUD
              - PHP
              - USD
              - KRW
              - MYR
              - IDR
              - VND
              - JPY
              - USDC
              - CAD
              - NGN
              - ZAR
              - KES
              - GHS
              - XAF
              - XOF
              - BRL
              - THB
            default: AUD
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - available_balance
                  - incoming_balance
                  - outgoing_balance
                  - rolling_reserve_balance
                  - withdrawable_balance
                properties:
                  available_balance:
                    type: number
                    example: 1000
                    description: The balance available for all transactions.
                  incoming_balance:
                    type: number
                    example: 1000
                    description: >-
                      The balance shows successful payments but the 3rd party
                      device has not yet paid for it.
                  outgoing_balance:
                    type: number
                    example: 1000
                    description: >-
                      The balance being transferred is waiting to be taken from
                      the available balance to process actions.
                  rolling_reserve_balance:
                    type: number
                    example: 1000
                    description: >-
                      The floating amount a merchant keeps in their balance.
                      Rolling reserve balance is not mandatory. The merchant can
                      request to reserve balance by contacting tech support.
                  withdrawable_balance:
                    type: number
                    example: 1000
                    description: The amount you can withdraw excludes rolling reserves.
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
              example:
                errors:
                  code: REQUIRE_LOGIN
                  message: Not Authorised
      security:
        - app-id: []
          secret-key: []
components:
  securitySchemes:
    app-id:
      type: apiKey
      in: header
      name: app-id
      description: |
        A unique identifier assigned to each application.
    secret-key:
      type: apiKey
      in: header
      name: secret-key
      description: |
        A secure token associated with the `app-id`.

````

## Related topics

- [Get Balance History V2](/api/balance/get-balance-history-v2.md)
- [Balance API Reference (v2)](/api/v2/balance.md)
- [Get Balance Details](/api/balance/get-balance-details.md)