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

# Get all transactions

`GET /transactions`

Returns all transactions related to a balance account with a payment instrument of type **bankAccount**.

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

## Query parameters

- `balancePlatform` string
- `accountHolderId` string
- `balanceAccountId` string
- `cursor` string
- `createdSince` string, date-time, required
- `createdUntil` string, date-time, required
- `limit` integer

## Response `200`

OK - the request has succeeded.

- TransactionSearchResponse
  - `_links` Links
    - `next` Link
      - `href` string
    - `prev` Link
      - `href` string
  - `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).
      - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `balanceAccountId` string, required — Unique identifier of the balance account.
    - `balancePlatform` string, required — Unique identifier of the balance platform.
    - `bookingDate` string, date-time, required — The date the transaction was booked to the balance account.
    - `category` 'bank' | 'grants' | 'internal' | 'issuedCard' | 'platformPayment' — 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 — 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
        - `mcc` string — The merchant category code.
        - `merchantId` string — The merchant identifier.
        - `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 merchant postal code.
      - `transferInstrumentId` string — 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.
    - `description` string — The `description` from the `/transfers` request.
    - `id` string, required — Unique identifier of the transaction.
    - `instructedAmount` Amount
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
      - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `paymentInstrumentId` string — 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' | 'balanceRollover' | 'bankTransfer' | 'capture' | 'captureReversal' | 'chargeback' | 'chargebackReversal' | 'depositCorrection' | 'directDebit' | 'fee' | 'grant' | 'installment' | 'installmentReversal' | 'internalTransfer' | 'invoiceDeduction' | 'leftover' | 'manualCorrection' | 'miscCost' | 'payment' | 'paymentCost' | 'refund' | 'refundReversal' | 'repayment' | 'reserveAdjustment' | 'secondChargeback' — 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

- **2023-01-10** (v1) `2cb4e0690ae2` — 1 warning
  - added the new `balanceRollover` enum value to the `data/items/type` response property for the response status `200`
- **2022-11-28** (v1) `02d77153ae6b` — 1 warning, 1 info
  - added the new `directDebit` enum value to the `data/items/type` response property for the response status `200`
  - the response required property `data/items/id` became not read-only for the status `200`
- **2022-10-04** (v1) `5050c5535aca` — 4 breaking, 1 warning
  - the response property `data/items/instructedAmount` became optional for the status `200`
  - the response property `data/items/paymentInstrumentId` became optional for the status `200`
  - the response property `data/items/referenceForBeneficiary` became optional for the status `200`
  - the response property `data/items/transferId` became optional for the status `200`
  - …1 more
- **2022-09-07** (v1) `4a2a50ba39a0` — 1 warning
  - added the new `installmentReversal` enum value to the `data/items/type` response property for the response status `200`
- **2022-09-02** (v1) `a6fcc469131a` — 1 info
  - endpoint added

[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/2cb4e0690ae2/schema)