---
title: "Get all transactions"
method: GET
path: "/transactions"
tags: ["Transactions"]
---

# Get all transactions

`GET /transactions`

>Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.

Returns all the transactions related to a balance account, account holder, or balance platform.

When making this request, you must include at least one of the following:
- `balanceAccountId`
- `accountHolderId`
- `balancePlatform`.

This endpoint supports cursor-based pagination. The response returns the first page of results, and returns links to the next and previous pages when applicable. You can use the links to page through the results.

## Query parameters

- `balancePlatform` string
- `paymentInstrumentId` string
- `accountHolderId` string
- `balanceAccountId` string
- `cursor` string
- `createdSince` string, date-time, required
- `createdUntil` string, date-time, required
- `sortOrder` 'asc' | 'desc'
- `limit` integer

## Response `200`

OK - the request has succeeded.

- TransactionSearchResponse
  - `_links` Links
    - `next` Link
      - `href` string — The link to the resource.
    - `prev` Link
      - `href` string — The link to the resource.
  - `data` Transaction[] — Contains the transactions that match the query parameters.
    - `accountHolderId` string, required — Unique identifier of the account holder.
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `balanceAccountId` string, required — Unique identifier of the balance account.
    - `balancePlatform` string, required — The unique identifier of the balance platform.
    - `bookingDate` string, date-time, required — The date the transaction was booked into the balance account.
    - `category` 'bank' | 'card' | 'grants' | 'interest' | 'internal' | 'issuedCard' | 'migration' | 'platformPayment' | 'topUp' | 'upgrade' — The category of the transaction indicating the type of activity. Possible values: * **platformPayment**: The transaction is a payment or payment modification made with an Adyen merchant account. * **internal**: The transaction resulted from an internal adjustment such as a deposit correction or invoice deduction. * **bank**: The transaction is a bank-related activity, such as sending a payout or receiving funds. * **issuedCard**: The transaction is a card-related activity, such as using an Adyen-issued card to pay online.
    - `counterparty` Counterparty, required
      - `balanceAccountId` string — The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
      - `bankAccount` BankAccountInfo
        - `address` Address
          - `city` string, required — The name of the city. Maximum length: 3000 characters.
          - `country` string, required — The two-character ISO-3166-1 alpha-2 country code. For example, **US**. > If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`.
          - `houseNumberOrName` string, required — The number or name of the house. Maximum length: 3000 characters.
          - `postalCode` string, required — A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries.
          - `stateOrProvince` string — The two-character ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada.
          - `street` string, required — The name of the street. Maximum length: 3000 characters. > The house number should not be included in this field; it should be separately provided via `houseNumberOrName`.
        - `iban` string — The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
        - `ownerName` Name
          - `firstName` string — The first name.
          - `fullName` string — The full name.
          - `infix` string — The infix in the name, if any.
          - `lastName` string — The last name.
      - `merchant` MerchantData
        - `acquirerId` string — The unique identifier of the merchant's acquirer.
        - `mcc` string — The merchant category code.
        - `merchantId` string — The unique identifier of the merchant.
        - `nameLocation` NameLocation
          - `city` string — The city where the merchant is located.
          - `country` string — The country where the merchant is located in [three-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format.
          - `countryOfOrigin` string — The home country in [three-digit country code](https://en.wikipedia.org/wiki/ISO_3166-1_numeric) format, used for government-controlled merchants such as embassies.
          - `name` string — The name of the merchant's shop or service.
          - `rawData` string — The raw data.
          - `state` string — The state where the merchant is located.
        - `postalCode` string — The postal code of the merchant.
      - `transferInstrumentId` string — The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/transferInstruments__resParam_id).
    - `createdAt` string, date-time, required — The date the transaction was created.
    - `creationDate` string, date-time — The date and time when the event was triggered, in ISO 8601 extended format. For example, **2025-03-19T10:15:30+01:00**.
    - `description` string — The `description` from the `/transfers` request.
    - `id` string, required — The unique identifier of the transaction.
    - `instructedAmount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `paymentInstrumentId` string — The unique identifier of the payment instrument that was used for the transaction.
    - `reference` string, required — The [`reference`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_reference) from the `/transfers` request. If you haven't provided any, Adyen generates a unique reference.
    - `referenceForBeneficiary` string — The reference sent to or received from the counterparty. * For outgoing funds, this is the [`referenceForBeneficiary`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__resParam_referenceForBeneficiary) from the [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_referenceForBeneficiary) request. * For incoming funds, this is the reference from the sender.
    - `status` 'booked' | 'pending', required — The status of the transaction. Possible values: * **pending**: The transaction is still pending. * **booked**: The transaction has been booked to the balance account.
    - `transferId` string — Unique identifier of the related transfer.
    - `type` 'atmWithdrawal' | 'atmWithdrawalReversal' | 'balanceAdjustment' | 'balanceMigration' | 'balanceRollover' | 'bankDirectDebit' | 'bankTransfer' | 'capitalFundsCollection' | 'capture' | 'captureReversal' | 'cardTransfer' | 'cashOutFee' | 'cashOutFunding' | 'cashOutInstruction' | 'cashoutFee' | 'cashoutFunding' | 'cashoutRepayment' | 'chargeback' | 'chargebackCorrection' | 'chargebackReversal' | 'chargebackReversalCorrection' | 'depositCorrection' | 'fee' | 'grant' | 'installment' | 'installmentReversal' | 'interestPayout' | 'internalDirectDebit' | 'internalTransfer' | 'invoiceDeduction' | 'leftover' | 'manualCorrection' | 'miscCost' | 'payment' | 'paymentCost' | 'refund' | 'refundReversal' | 'repayment' | 'reserveAdjustment' | 'secondChargeback' | 'secondChargebackCorrection' — The type of the transaction. Possible values: **payment**, **capture**, **captureReversal**, **refund** **refundReversal**, **chargeback**, **chargebackReversal**, **secondChargeback**, **atmWithdrawal**, **atmWithdrawalReversal**, **internalTransfer**, **manualCorrection**, **invoiceDeduction**, **depositCorrection**, **bankTransfer**, **miscCost**, **paymentCost**, **fee**
    - `valueDate` string, date-time, required — The date the transfer amount becomes available in the balance account.

## Other responses

- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2025-06-24** (v1) `9e3fb59b9891` — 1 info
  - added the new optional `query` request parameter `sortOrder`
- **2025-05-21** (v1) `7d50c61d15a0` — 2 warning
  - added the new `interest` enum value to the `data/items/category` response property for the response status `200`
  - added the new `interestPayout` enum value to the `data/items/type` response property for the response status `200`
- **2024-07-17** (v1) `442da14d7ff0` — 3 warning
  - added the new `cashoutFee` enum value to the `data/items/type` response property for the response status `200`
  - added the new `cashoutFunding` enum value to the `data/items/type` response property for the response status `200`
  - added the new `cashoutRepayment` enum value to the `data/items/type` response property for the response status `200`
- **2024-05-02** (v1) `3cbb09de4cb8` — 1 warning
  - added the new `capitalFundsCollection` enum value to the `data/items/type` response property for the response status `200`
- **2024-03-04** (v1) `2b890cadd368` — 2 warning
  - added the new `bankDirectDebit` enum value to the `data/items/type` response property for the response status `200`
  - added the new `internalDirectDebit` enum value to the `data/items/type` response property for the response status `200`

[Full history](https://skmtc.dev/adyen/apis/transferservice/changes/transactions/get.md)

---

[API](https://skmtc.dev/adyen/apis/transferservice.md) · [All operations](https://skmtc.dev/adyen/apis/transferservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/transferservice/revisions/13735824b8e3/schema)