---
title: "Get Payment Balance Transactions"
method: GET
path: "/payments/{id}/payment_balance_transactions"
tags: ["Payments"]
---

# Get Payment Balance Transactions

`GET /payments/{id}/payment_balance_transactions`

## Request

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

Get information about the payment-balance-transactions associated with a payment.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Successfully retrieve the payment-balance-transactions for a payment

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` PaymentBalanceTransaction[]: the list of objects
    - `id` string, uuid: unique payment balance transaction id
    - `amount` number: payment balance transaction amount, in cents
    - `balance` number: balance amount of the payment balance transaction, in cents
    - `currency` 'usd' | 'cad'
    - `financial_transaction_id` string, uuid: id of the financial transaction associated with the payment balance transaction
    - `payment_id` string, uuid: id of the payment associated with the payment balance transaction
    - `payment_balance_txn_type` 'payment' | 'payment_fee' | 'processing_fee' | 'platform_fee' | 'payout' | 'refund' | 'refund_failure' | 'refund_processing_fee' | 'fee_refund' | 'void' | 'dispute' | 'dispute_fee' | 'dispute_fee_refund' | 'dispute_refund' | 'ach_return' | 'ach_return_fee' | 'application_fee_returned' | 'processing_fee_return' | 'platform_fee_return': Type of the transaction object associated with the payment balance transaction. - `payment`: Payment amount credited to the merchant - `payment_fee`: Application fee charged on the payment - `processing_fee`, `platform_fee`: Fees charged on the payment under [Enhanced Fee Management](#section/Enhanced-Fee-Management) - `refund`, `refund_failure`, `fee_refund`, `refund_processing_fee`: Refund and the fees returned or charged with it - `void`: Payment voided before settlement - `dispute`, `dispute_fee`, `dispute_refund`, `dispute_fee_refund`: Dispute amount and fee, and their reversals - `ach_return`: Payment amount reversed when an ACH payment is returned - `ach_return_fee`: Flat fee charged when an ACH payment is returned by the bank - `application_fee_returned`, `processing_fee_return`, `platform_fee_return`: Fees from the original payment returned on an ACH return See [ACH Returns](https://docs.justifi.tech/paymentMethods/achReturns) for how these combine on a returned ACH payment.
    - `source_id` string, uuid: id of the source object associated with the payment balance transaction
    - `source_type` string: type of the source object associated with the payment balance transaction (for example `Payment`, `ApplicationFee`, `PaymentFee`, `Refund`, `Dispute`, `AchReturnFee`)
    - `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)