---
title: "List transaction balances"
method: GET
path: "/statements-v2/v1/accounts/{accountId}/transactions-balance"
tags: ["Statement"]
---

# List transaction balances

`GET /statements-v2/v1/accounts/{accountId}/transactions-balance`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/statements-v2/v1/accounts/{accountId}/transactions-balance`
- Auth: HTTP bearer

List transaction balances.

Use this endpoint to retrieve the details for one or more transactions. This endpoint could be useful if your customer has a dispute or needs credit card refinancing.

**Note:** This endpoint requires an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a **401 Unauthorized** message.

## Path parameters

- `accountId` integer, required

## Query parameters

- `statementId` integer
- `transactionIds` integer[]
- `transactionTypeId` integer[]
- `hasBalance` boolean
- `page` integer
- `perPage` integer
- `withStatements` boolean
- `balanceType` 'OPEN' | 'CLOSED' | 'CLOSED_NOT_DUE' | 'FUTURE'

## Response `200`

Ok

- TransactionsBalanceListResponse
  - `current_page` integer: Current page
  - `per_page` integer: Items per page
  - `total_items` integer: Number of items found
  - `pages` integer: Number of pages
  - `is_last_page` boolean: Is this the last page?
  - `items` TransactionsBalanceResponse[]
    - `transaction_id` integer: Transaction ID
    - `program_id` integer: Program ID
    - `statement_id` integer: Statement ID
    - `amount` number, float: Transaction amount
    - `tax_amount` number, float: Tax amount
    - `interest_rate` number, float: Transaction interest rate.
    - `interest_amount` number, float: Interest amount. Maximum of 2 digits allowed after the decimal place.
    - `balance_amount` number, float: Transaction balance. Unpaid balance for this transaction.
    - `event_datetime` string, date-time: Event datetime. Format = yyyy-mm-dd:hr:mm:ss.
    - `installment_number` integer: Installment number
    - `number_of_installments` integer: Number of installments
    - `transaction_type_id` integer: Transaction type ID
    - `statement` StatementObject
      - `statement_id` integer: Statement ID
      - `cycle` integer: Cycle number. When an account is created, its first cycle is cycle number 1. This number is incremented for each successive cycle.
      - `cycle_closing_date` string, date: Cycle closing date. Format = yyyy-mm-dd.
      - `due_date` string, date: Due date. Format = yyyy-mm-dd.
      - `real_due_date` string, date: Real due date. The regular due date does not take holidays into account. The real due date does, so it might be a later date. Format = yyyy-mm-dd.
      - `previous_balance` number, float: Amount you owed on the account when the previous statement closed.
      - `debits` number, float: Total debits for current cycle
      - `credits` number, float: Total credits for current cycle
      - `current_balance` number: Total amount you owe on the account right now. It updates as transactions post, so it can change many times during a billing cycle. `current_balance` = `previous_balance` + `debits` - `credits`.
      - `minimum_payment` number, float: Statement minimum payment
      - `status` string: Statement status. The possible values are: * `CLOSED`: Statement is closed, and the due date has already passed. * `CLOSED_NOT_DUE`: Statement is closed, but the due date has not yet passed. In other words, the current date is between the statement's cycle closing date and due date. * `OPEN`: Statement is open. This is the current statement, before cycle closing. * `FUTURE`: Future statement. That is, a statement that has not been opened yet. Statements with this status usually include installments from purchases that will be due in future billing cycles.

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/revolving-credit-statements.md) - [All operations](https://skmtc.dev/pismo/apis/revolving-credit-statements/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/revolving-credit-statements/revisions/09f552b0f850?raw)