---
title: "Get Balance"
method: GET
path: "/v3/banking/balance"
---

# Get Balance

`GET /v3/banking/balance`

This API lets the platform fetch the current balance of a virtual account.

## Query parameters

- `consumer_urn` string
- `account_number` string, required
- `custom_va_number` string
- `customer_va_identifier` string
- `fetch_child_balance` boolean
- `provider_code` string
- `fetch_compliance_balance` string

## Headers

- `client_id` string, required
- `client_secret` string, required

## Request body

- unknown

## Response `200`

200

- union
  - object
    - `decentro_txn_id` string
    - `api_status` string
    - `message` string
    - `data` object
      - `account_balance` object
        - `account_number` string
        - `account_type` string
        - `current_balance` integer
        - `minimum_balance` integer
  - object
    - `decentro_txn_id` string
    - `api_status` string
    - `message` string
    - `data` object
      - `consumer_cumulative_balance` number
  - object
    - `decentro_txn_id` string
    - `api_status` string
    - `message` string
    - `data` object
      - `customer_va_identifier_cumulative_balance` integer
  - object
    - `decentro_txn_id` string
    - `api_status` string
    - `message` string
    - `response_key` string

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)