---
title: "Balance: Transactions"
method: GET
path: "/merchants/{merchant_id}/balances/{currency}/transactions"
tags: ["Platform Model"]
---

# Balance: Transactions

`GET /merchants/{merchant_id}/balances/{currency}/transactions`

## Request

- Base URL: `https://komoju.com/api/v1`
- URL: `https://komoju.com/api/v1/merchants/{merchant_id}/balances/{currency}/transactions`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/komoju/apis/komoju-api/docs/merchants/:merchant_id/balances/:currency/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Given a currency, view the ledger transactions of the currently authenticated merchant or one of its sub-merchants.
Will split ledger transactions into line items when appropriate.

## Path parameters

- `merchant_id` string, required: A unique 25-character alphanumeric resource identifier.
- `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.dev/komoju/apis/komoju-api.md) - [All operations](https://skmtc.dev/komoju/apis/komoju-api/llms.txt) - [OpenAPI document](https://skmtc.dev/komoju/apis/komoju-api/revisions/65483c40ba32?raw)