---
title: "Get a list of transactions"
method: POST
path: "/accountHolderTransactionList"
tags: ["General"]
---

# Get a list of transactions

`POST /accountHolderTransactionList`

Returns a list of transactions for an account holder's accounts. You can specify the accounts and transaction statuses to be included on the list. The call returns a maximum of 50 transactions for each account. To retrieve all transactions, you must make another call with the 'page' value incremented. Transactions are listed in chronological order, with the most recent transaction first.

## Request body

- AccountHolderTransactionListRequest
  - `accountHolderCode` string, required — The code of the account holder that owns the account(s) of which retrieve the transaction list.
  - `transactionListsPerAccount` TransactionListForAccountWrapper[] — A list of accounts to include in the transaction list. If left blank, the last fifty (50) transactions for all accounts of the account holder will be included.
    - `TransactionListForAccount` TransactionListForAccount
      - `accountCode` string, required — The account for which to retrieve the transactions.
      - `page` integer, required — The page of transactions to retrieve. Each page lists fifty (50) transactions. The most recent transactions are included on page 1.
  - `transactionStatuses` string[] — A list of statuses to include in the transaction list. If left blank, all transactions will be included. >Permitted values: >* `PendingCredit` - a pending balance credit. >* `CreditFailed` - a pending credit failure; the balance will not be credited. >* `Credited` - a credited balance. >* `PendingDebit` - a pending balance debit (e.g., a refund). >* `CreditClosed` - a pending credit closed; the balance will not be credited. >* `CreditSuspended` - a pending credit closed; the balance will not be credited. >* `DebitFailed` - a pending debit failure; the balance will not be debited. >* `Debited` - a debited balance (e.g., a refund). >* `DebitReversedReceived` - a pending refund reversal. >* `DebitedReversed` - a reversed refund. >* `ChargebackReceived` - a received chargeback request. >* `Chargeback` - a processed chargeback. >* `ChargebackReversedReceived` - a pending chargeback reversal. >* `ChargebackReversed` - a reversed chargeback. >* `Converted` - converted. >* `ManualCorrected` - manual booking/adjustment by Adyen. >* `Payout` - a payout. >* `PayoutReversed` - a reversed payout. >* `PendingFundTransfer` - a pending transfer of funds from one account to another. >* `FundTransfer` - a transfer of funds from one account to another.

## Response `200`

OK - the request has succeeded.

- AccountHolderTransactionListResponse
  - `accountTransactionLists` AccountTransactionListWrapper[] — A list of the transactions.
    - `AccountTransactionList` AccountTransactionList
      - `accountCode` string — The code of the account.
      - `hasNextPage` boolean — Indicates whether there is a next page of transactions available.
      - `transactions` TransactionWrapper[] — The list of transactions.
        - `Transaction` Transaction
          - `amount` 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).
          - `bankAccountDetail` BankAccountDetail
            - `accountNumber` string — The bank account number (without separators). >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `accountType` string — The type of bank account. Only applicable to bank accounts held in the USA. The permitted values are: `checking`, `savings`. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `bankAccountName` string — The name of the bank account.
            - `bankAccountUUID` string — The unique identifier (UUID) of the Bank Account. >If, during an account holder create or update request, this field is left blank (but other fields provided), a new Bank Account will be created with a procedurally-generated UUID. >If, during an account holder create request, a UUID is provided, the creation of the Bank Account will fail while the creation of the account holder will continue. >If, during an account holder update request, a UUID that is not correlated with an existing Bank Account is provided, the update of the account holder will fail. >If, during an account holder update request, a UUID that is correlated with an existing Bank Account is provided, the existing Bank Account will be updated.
            - `bankBicSwift` string — The bank identifier code. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `bankCity` string — The city in which the bank branch is located. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `bankCode` string — The bank code of the banking institution with which the bank account is registered. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `bankName` string — The name of the banking institution with which the bank account is held. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `branchCode` string — The branch code of the branch under which the bank account is registered. The value to be specified in this parameter depends on the country of the bank account: * United States - Routing number * United Kingdom - Sort code * Germany - Bankleitzahl >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `checkCode` string — The check code of the bank account. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `countryCode` string — The two-letter country code in which the bank account is registered. >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL'). >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `currencyCode` string — The currency in which the bank account deals. >The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').
            - `iban` string — The international bank account number. >The IBAN standard is defined in ISO-13616. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerCity` string — The city of residence of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerCountryCode` string — The country code of the country of residence of the bank account owner. >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL'). >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerDateOfBirth` string — The date of birth of the bank account owner. The date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).
            - `ownerHouseNumberOrName` string — The house name or number of the residence of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerName` string — The name of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerNationality` string — The country code of the country of nationality of the bank account owner. >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL'). >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerPostalCode` string — The postal code of the residence of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerState` string — The state of residence of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `ownerStreet` string — The street name of the residence of the bank account owner. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `primaryAccount` boolean — If set to true, the bank account is a primary account.
            - `taxId` string — The tax ID number. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
            - `urlForVerification` string — The URL to be used for bank account verification. This may be generated on bank account creation. >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information) for details on field requirements.
          - `captureMerchantReference` string — The merchant reference of a related capture.
          - `capturePspReference` string — The psp reference of a related capture.
          - `creationDate` string, date-time — The date on which the transaction was performed.
          - `description` string — A description of the transaction.
          - `destinationAccountCode` string — The code of the account to which funds were credited during an outgoing fund transfer.
          - `disputePspReference` string — The psp reference of the related dispute.
          - `disputeReasonCode` string — The reason code of a dispute.
          - `merchantReference` string — The merchant reference of a transaction.
          - `paymentPspReference` string — The psp reference of the related authorisation or transfer.
          - `payoutPspReference` string — The psp reference of the related payout.
          - `pspReference` string — The psp reference of a transaction.
          - `sourceAccountCode` string — The code of the account from which funds were debited during an incoming fund transfer.
          - `transactionStatus` 'BalanceNotPaidOutTransfer' | 'BalancePlatformFundTransfer' | 'BalancePlatformSweep' | 'BalancePlatformSweepReturned' | 'Chargeback' | 'ChargebackCorrection' | 'ChargebackCorrectionReceived' | 'ChargebackReceived' | 'ChargebackReversed' | 'ChargebackReversedCorrection' | 'ChargebackReversedCorrectionReceived' | 'ChargebackReversedReceived' | 'Converted' | 'CreditClosed' | 'CreditFailed' | 'CreditReversed' | 'CreditReversedReceived' | 'CreditSuspended' | 'Credited' | 'DebitFailed' | 'DebitReversedReceived' | 'Debited' | 'DebitedReversed' | 'DepositCorrectionCredited' | 'DepositCorrectionDebited' | 'DepositCorrectionReceived' | 'Fee' | 'FeeReceived' | 'FundTransfer' | 'FundTransferReversed' | 'InvoiceDeductionCredited' | 'InvoiceDeductionDebited' | 'InvoiceDeductionReceived' | 'ManualCorrected' | 'ManualCorrectionCredited' | 'ManualCorrectionDebited' | 'MerchantPayin' | 'MerchantPayinReceived' | 'MerchantPayinReversed' | 'Payout' | 'PayoutReversed' | 'PendingCredit' | 'PendingDebit' | 'PendingFundTransfer' | 'ReCredited' | 'ReCreditedReceived' | 'SecondChargeback' | 'SecondChargebackCorrection' | 'SecondChargebackCorrectionReceived' | 'SecondChargebackReceived' — The status of the transaction. >Permitted values: `PendingCredit`, `CreditFailed`, `CreditClosed`, `CreditSuspended`, `Credited`, `Converted`, `PendingDebit`, `DebitFailed`, `Debited`, `DebitReversedReceived`, `DebitedReversed`, `ChargebackReceived`, `Chargeback`, `ChargebackReversedReceived`, `ChargebackReversed`, `Payout`, `PayoutReversed`, `FundTransfer`, `PendingFundTransfer`, `ManualCorrected`.
          - `transferCode` string — The transfer code of the transaction.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `400` — Bad Request - a problem reading or understanding the request.
- `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.

---

[API](https://skmtc.net/adyen/apis/fundservice.md) · [All operations](https://skmtc.net/adyen/apis/fundservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/fundservice/revisions/9b4819139946/schema)