---
title: "Get balance transactions"
method: GET
path: "/v1/accounts/{id}/balance/transactions"
tags: ["Accounts"]
---

# Get balance transactions

`GET /v1/accounts/{id}/balance/transactions`

Returns the transaction history of a balance account: deposit credits, payout debits, and reversals, newest-first with cursor pagination.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number
- `cursor` string

## Headers

- `X-API-Key` string

## Response `200`

Balance transactions

- BalanceTransactionsResponseDto
  - `data` BalanceTransactionDto[], required
    - `id` string, required — Transaction ID
    - `amount` string, required — Signed amount in minor units — positive credits the balance, negative debits it
    - `currency` string, required — Currency
    - `description` string, nullable — What the transaction was
    - `postedAt` string, nullable — When the transaction posted
  - `hasMore` boolean, required — Whether more transactions exist
  - `nextCursor` string, nullable — Cursor for the next page when hasMore is true

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

---

[API](https://skmtc.dev/infinite/apis/infinite-api.md) · [All operations](https://skmtc.dev/infinite/apis/infinite-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infinite/infinite-api/revisions/70223aefae8c/schema)