---
title: "List Balance Transactions"
method: GET
path: "/balance_transactions"
tags: ["Balance Transactions"]
---

# List Balance Transactions

`GET /balance_transactions`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/balance_transactions`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/balance_transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

List the balance transactions for your account. This API is limited to a single sub account or payout. This endpoint supports [pagination](https://docs.justifi.tech/api-spec#section/Pagination).

## Query parameters

- `payout_id` string
- `source_payment_id` string

## Headers

- `Authorization` string, required
- `Sub-Account` string

## Response `200`

Successfully list balance transactions

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` BalanceTransaction[]: the list of objects
    - `id` string: unique balance transaction id
    - `account_id` string, uuid: id of the account associated with the balance transaction
    - `amount` number: balance transaction amount, in cents
    - `available_on` string, date-time
    - `currency` 'usd' | 'cad'
    - `description` string, nullable
    - `fee` number: amount of fees deducted from the balance transaction amount, in cents
    - `financial_transaction_id` string, uuid: id of the financial transaction associated with the balance transaction
    - `net` number: net amount of the balance transaction (after fees are deducted), in cents
    - `payout_id` string, uuid: id of the payout associated with the balance transaction
    - `source_id` string, uuid: id of the source object associated with the balance transaction
    - `source_type` string: type of source object associated with the balance transaction (for example payment, refund, dispute, payout)
    - `source_payment_id` string, nullable: id of the payment associated with the source of the balance transaction
    - `txn_type` string: Type of transaction object associated with the balance transaction. Common types include: - `seller_payment`: Payment amount credited to merchant - `seller_payment_refund`: Payment refund debited from merchant - `processing_fee`: Processing fee deducted from merchant - `processing_fee_credit`: Processing fee credited to platform - `platform_fee`: Platform fee deducted from merchant - `platform_fee_credit`: Platform fee credited to platform - `processing_fee_return`: Processing fee returned on refund/void/ACH return - `platform_fee_return`: Platform fee returned on refund/void/ACH return - `partner_platform_discount_fee`: JustiFi basis point fee deducted from platform - `partner_platform_transaction_fee`: JustiFi per-transaction fee deducted from platform - `payout`: Payout to bank account - `refund`: Refund transaction - `ach_return_collected`: Returned ACH payment amount debited from merchant - `ach_return_fee_collected`: ACH return fee debited from merchant - `application_fee_refund`: Application fee returned to merchant on refund/void/ACH return - `dispute_amount_collected`: Disputed payment amount debited from merchant - `dispute_fee_collected`: Dispute fee debited from merchant - `refund_reversal`: Returned ACH refund credited back to merchant - `payout_failed`: Returned payout credited back to merchant A `_collected` suffix means the amount was taken from this account to fund a recovery, so it is recorded as a debit. See [Enhanced Fee Management](#section/Enhanced-Fee-Management) for details on fee-related transaction types, and [ACH Returns](https://docs.justifi.tech/paymentMethods/achReturns) for the transactions a returned ACH payment produces.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page_info` PageInfo
    - `end_cursor` string: the encoded id of the last record in the current list
    - `has_next` boolean: true if the collection contains records following the current list
    - `has_previous` boolean: true if the collection contains records ahead of the current list
    - `start_cursor` string: the encoded id of the first record in the current list

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)