--- title: "List balance transactions" method: GET path: "/balances/{balanceId}/transactions" tags: ["Balances API"] --- # List balance transactions `GET /balances/{balanceId}/transactions` ## Request - Base URL: `https://api.mollie.com/v2` - URL: `https://api.mollie.com/v2/balances/{balanceId}/transactions` - Auth: one of: - HTTP bearer - OAuth 2 - Authorization code: `https://my.mollie.com/oauth2/authorize` - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `balances.read` Retrieve a list of all balance transactions. Transactions include for example payments, refunds, chargebacks, and settlements. For an aggregated report of these balance transactions, refer to the [Get balance report](get-balance-report) endpoint. The alias `primary` can be used instead of the balance ID to refer to the organization's primary balance. The results are paginated. > 🔑 Access with > > [Advanced access token with **balances.read**](/reference/authentication) > > [OAuth access with **balances.read**](/reference/authentication) ## Query parameters - `from` string - `limit` integer, nullable - `testmode` boolean ## Response `200` A list of balance transaction objects. - object - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items. - `_embedded` object, required - `balance_transactions` object[], required: An array of balance transaction objects. - `resource` string, required: Indicates the response contains a balance transaction object. Will always contain the string `balance-transaction` for this endpoint. - `id` string, required: The identifier uniquely referring to this balance transaction. - `type` string, required: The type of transaction, for example `payment` or `refund`. Values include the below examples, although this list is not definitive. * Regular payment processing: `payment` `capture` `unauthorized-direct-debit` `failed-payment` * Refunds and chargebacks: `refund` `returned-refund` `chargeback` `chargeback-reversal` * Settlements: `outgoing-transfer` `canceled-outgoing-transfer` `returned-transfer` * Invoicing: `invoice-compensation` `balance-correction` * Mollie Connect: `application-fee` `split-payment` `platform-payment-refund` `platform-payment-chargeback` Possible values: `api-payment-rolling-reserve-release` `application-fee` `balance-charge-fee` `balance-correction` `balance-reserve` `balance-reserve-return` `balance-topup` `bank-charged-failure-fee` `canceled-transfer` `capture` `cash-collateral-issuance` `cash-collateral-release` `chargeback` `chargeback-compensation` `chargeback-reversal` `failed-payment` `failed-payment-fee` `failed-platform-split-payment` `failed-split-payment-compensation` `fee-prepayment` `held-rolling-reserve` `incoming-transfer` `invoice-compensation` `invoice-rounding-compensation` `loan` `movement` `outgoing-custom-amount-transfer` `outgoing-transfer` `payment` `payment-fee` `pending-rolling-reserve` `platform-payment-chargeback` `platform-payment-refund` `post-payment-split-payment` `refund` `refund-compensation` `released-rolling-reserve` `repayment` `returned-platform-payment-refund` `returned-refund` `returned-refund-compensation` `returned-transfer` `reversed-chargeback-compensation` `reversed-platform-payment-chargeback` `rolling-reserve-hold` `rolling-reserve-release` `split-payment` `split-transaction` `to-be-released-rolling-reserve` `topup` - `resultAmount` object, required: The final amount that was moved to or from the balance. If the transaction moves funds away from the balance, for example when it concerns a refund, the amount will be negative. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `initialAmount` object, required: The amount that was to be moved to or from the balance, excluding deductions. If the transaction moves funds away from the balance, for example when it concerns a refund, the amount will be negative. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `deductions` object, nullable: The total amount of deductions withheld from the movement. For example, if we charge a €0.29 fee on a €10 payment, the deductions amount will be `{"currency":"EUR", "value":"-0.29"}`. When moving funds to a balance, we always round the deduction to a 'real' amount. Any differences between these real-time rounded amounts and the final invoice will be compensated when the invoice is generated. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `deductionDetails` object, nullable: A detailed breakdown of the deductions withheld from the movement. Each field represents a specific type of deduction applied to the transaction. Only the applicable fields will be present. - `fees` object, nullable: The amount deducted for all transaction fees. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `commissions` object, nullable: The amount deducted for commissions (e.g Application fees). - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `repayments` object, nullable: The amount deducted for Mollie Capital repayments. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `reservations` object, nullable: The amount deducted for rolling reservations. - `currency` string, required: A three-character ISO 4217 currency code. - `value` string, required: A string containing an exact monetary amount in the given currency. - `context` object, nullable: Depending on the type of the balance transaction, we will try to give more context about the specific event that triggered it. For example, the context object for a payment transaction will look like `{"paymentId": "tr_5B8cwPMGnU6qLbRvo7qEZo", "paymentDescription": "Description"}`. Below is a complete list of the context values that each type of transaction will have. * Type `payment`: `paymentId`, `paymentDescription` * Type `capture`: `paymentId` `captureId`, `paymentDescription`, `captureDescription` * Type `capture-commission`: `paymentId`, `paymentDescription`, `organizationId` * Type `capture-rolling-reserve-release`: `paymentId`, `paymentDescription`, `captureId`, `captureDescription` * Type `unauthorized-direct-debit`: `paymentId`, `paymentDescription` * Type `failed-payment`: `paymentId`, `paymentDescription` * Type `refund`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `refund-compensation`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `returned-refund`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `returned-refund-compensation`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `chargeback`: `paymentId` `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `chargeback-reversal`: `paymentId`, `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `chargeback-compensation`: `paymentId`, `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `reversed-chargeback-compensation`: `paymentId`, `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `outgoing-transfer`: `settlementId` `transferId` * Type `canceled-outgoing-transfer`: `settlementId` `transferId` * Type `returned-transfer`: `settlementId` `transferId` * Type `invoice-compensation`: `invoiceId` * Type `balance-correction`: none * Type `application-fee`: `paymentId`, `paymentDescription`, `payingOwner` * Type `split-payment`: `paymentId`, `paymentDescription`, `paymentOwner` * Type `platform-payment-refund`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `returned-platform-payment-refund`: `paymentId` `refundId`, `paymentDescription`, `refundDescription` * Type `platform-payment-chargeback`: `paymentId` `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `reversed-platform-payment-chargeback`: `paymentId` `chargebackId`, `paymentDescription`, `chargebackDescription` * Type `payment-commission`: `paymentId`, `paymentDescription`, `organizationId` * Type `reimbursement-fee`: `paymentId`, `paymentDescription` * Type `failed-payment-fee`: `paymentId`, `paymentDescription` * Type `payment-fee`: `paymentId`, `paymentDescription` * Type `cash-advance-loan`: none * Type `platform-connected-organizations-fee`: none * Type `managed-fee`: `feeType`, `Id` * Type `returned-managed-fee`: `feeType`, `Id` * Type `topup`: none * Type `balance-reserve`: none * Type `balance-reserve-return`: none * Type `movement`: none * Type `post-payment-split-payment`: `paymentId` * Type `cash-collateral-issuance`: none * Type `cash-collateral-release`: none - `payment` object, nullable - `paymentId` string - `paymentDescription` string - `capture` object, nullable - `paymentId` string - `paymentDescription` string - `captureId` string - `captureDescription` string - `capture-commision` object, nullable - `paymentId` string - `paymentDescription` string - `captureId` string - `captureDescription` string - `capture-rolling-reserve-release` object, nullable - `paymentId` string - `paymentDescription` string - `captureId` string - `captureDescription` string - `unauthorized-direct-debit` object, nullable - `paymentId` string - `paymentDescription` string - `failed-payment` object, nullable - `paymentId` string - `paymentDescription` string - `refund` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `refund-compensation` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `returned-refund` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `returned-refund-compensation` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `chargeback` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `chargeback-reversal` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `chargeback-compensation` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `reversed-chargeback-compensation` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `outgoing-transfer` object, nullable - `transferId` string - `settlementId` string - `canceled-outgoing-transfer` object, nullable - `transferId` string - `settlementId` string - `returned-transfer` object, nullable - `transferId` string - `settlementId` string - `invoice-compensation` object, nullable - `invoiceId` string - `application-fee` object, nullable - `paymentId` string - `paymentDescription` string - `payingOwner` string - `split-payment` object, nullable - `paymentId` string - `paymentDescription` string - `paymentOnwer` string - `platform-payment-refund` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `returned-platform-payment-refund` object, nullable - `paymentId` string - `paymentDescription` string - `refundId` string - `refundDescription` string - `platform-payment-chargeback` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `reversed-platform-payment-chargeback` object, nullable - `paymentId` string - `paymentDescription` string - `chargebackId` string - `chargebackDescription` string - `payment-commission` object, nullable - `paymentId` string - `paymentDescription` string - `organizationId` string - `reimbursement-fee` object, nullable - `paymentId` string - `paymentDescription` string - `failed-payment-fee` object, nullable - `paymentId` string - `paymentDescription` string - `payment-fee` object, nullable - `paymentId` string - `paymentDescription` string - `managed-fee` object, nullable - `feeType` string - `feeId` string - `returned-managed-fee` object, nullable - `feeType` string - `feeId` string - `post-payment-split-payment` object, nullable - `paymentId` string - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field. - `self` object, required: The URL to the current set of items. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `previous` object, nullable, required: The previous set of items, if available. - `href` string: The actual URL string. - `type` string: The content type of the page or endpoint the URL points to. - `next` object, nullable, required: The next set of items, if available. - `href` string: The actual URL string. - `type` string: The content type of the page or endpoint the URL points to. - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. ## Other responses - `400`: The request contains issues. For example, if the specified `from` value is not a valid ID. - `404`: No entity with this ID exists. - `429`: Rate Limit has been reached. --- [API](https://skmtc.dev/mollie/apis/business-operations.md) - [All operations](https://skmtc.dev/mollie/apis/business-operations/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/business-operations/revisions/d51d76f4e5d9?raw)