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

# Balance: Transactions

`GET /balances/{currency}/transactions`

Given a currency, view the ledger transactions of the currently authenticated merchant.
Will split ledger transactions into line items when appropriate.

## 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.

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time
- `per_page` integer
- `page` integer
- `type` string

## Response `200`

200 response

- BalanceTransactionList
  - `resource` string, required — Resource type name for this list, always "list".
  - `data` Transaction[], required — Array of ledger transaction objects.
    - `id` string, required — A unique 25-character alphanumeric resource identifier.
    - `type` string, required — Type of ledger transaction (e.g. "payment", "fee", "disbursement").
    - `amount_cents` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `happened_at` string, date-time, required — Timestamp when this ledger transaction occurred.
  - `start_time` string, date-time, required — Start of the time range for records in this response.
  - `end_time` string, date-time, required — End of the time range for records in this response.
  - `total` integer, required — Total number of records matching the query.
  - `page` integer, required — Current page number.
  - `per_page` integer, required — Number of results per page.
  - `last_page` integer, required — Last available page number.

---

[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/revisions/65483c40ba32/schema)