---
title: "Balance: Show"
method: GET
path: "/balances/{currency}"
tags: ["Settlements"]
---

# Balance: Show

`GET /balances/{currency}`

Given a currency, view the unsettled balance of the currently authenticated merchant.

## Path parameters

- `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.

## Response `200`

200 response

- object
  - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
  - `total_balance_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `payments` object, required
    - `captured_amount_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `processing_fees_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `refunds` object, required
    - `refunded_amount_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `refund_processing_fees_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `refunded_customer_fees_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `platform_model` object
    - `fund_transfer_total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `payment_share_total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `payment_share_refund_total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `platform_fee_total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `platform_fee_refund_total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `submerchant_management_fees_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `total_cents` integer — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `corrections` object, required
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `komoju_card_charges` object, required
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `disbursements` object, required
    - `disbursement_amount_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `disbursement_fee_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
  - `misc` object, required
    - `clearings_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `komoju_card_discount_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `chargeback_fixed_fee_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `other_fee_adjustments_total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).
    - `total_cents` integer, required — Amount in the lowest denomination of the currency (e.g. cents for USD).

---

[API](https://skmtc.net/komoju/apis/komoju-api.md) · [All operations](https://skmtc.net/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komoju/komoju-api/versions/65483c40ba32/schema)