{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/main/json-schema/adyen-account-holder-transaction-list-response-schema.json",
  "title": "AccountHolderTransactionListResponse",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/adyen-accountholdertransactionlist-api-openapi.yml#/components/schemas/AccountHolderTransactionListResponse",
  "properties": {
    "accountTransactionLists": {
      "description": "A list of the transactions.",
      "items": {
        "$ref": "#/$defs/AccountTransactionList"
      },
      "type": "array"
    },
    "invalidFields": {
      "x-addedInVersion": "5",
      "description": "Contains field validation errors that would prevent requests from being processed.",
      "items": {
        "$ref": "#/$defs/ErrorFieldType"
      },
      "type": "array"
    },
    "pspReference": {
      "description": "The reference of a request. Can be used to uniquely identify the request.",
      "type": "string"
    },
    "resultCode": {
      "description": "The result code.",
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "AccountTransactionList": {
      "properties": {
        "accountCode": {
          "description": "The code of the account.",
          "type": "string"
        },
        "hasNextPage": {
          "description": "Indicates whether there is a next page of transactions available.",
          "type": "boolean"
        },
        "transactions": {
          "description": "The list of transactions.",
          "items": {
            "$ref": "#/$defs/Transaction"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "Amount": {
      "properties": {
        "currency": {
          "description": "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).",
          "maxLength": 3,
          "minLength": 3,
          "type": "string"
        },
        "value": {
          "description": "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "value",
        "currency"
      ],
      "type": "object"
    },
    "BankAccountDetail": {
      "properties": {
        "accountNumber": {
          "description": "The bank account number (without separators).\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "accountType": {
          "description": "The type of bank account.\nOnly applicable to bank accounts held in the USA.\nThe permitted values are: `checking`, `savings`.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankAccountName": {
          "description": "The name of the bank account.",
          "type": "string"
        },
        "bankAccountReference": {
          "x-addedInVersion": "5",
          "description": "Merchant reference to the bank account.",
          "type": "string"
        },
        "bankAccountUUID": {
          "description": "The unique identifier (UUID) of the Bank Account.\n>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.\n\n>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.\n\n>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.\n\n>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.\n",
          "type": "string"
        },
        "bankBicSwift": {
          "description": "The bank identifier code.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankCity": {
          "description": "The city in which the bank branch is located.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankCode": {
          "description": "The bank code of the banking institution with which the bank account is registered.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankName": {
          "description": "The name of the banking institution with which the bank account is held.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "branchCode": {
          "description": "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:\n* United States - Routing number\n* United Kingdom - Sort code\n* Germany - Bankleitzahl\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "checkCode": {
          "description": "The check code of the bank account.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "countryCode": {
          "description": "The two-letter country code in which the bank account is registered.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "currencyCode": {
          "description": "The currency in which the bank account deals.\n>The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').\n",
          "type": "string"
        },
        "iban": {
          "description": "The international bank account number.\n>The IBAN standard is defined in ISO-13616.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerCity": {
          "description": "The city of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerCountryCode": {
          "description": "The country code of the country of residence of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerDateOfBirth": {
          "deprecated": true,
          "description": "The date of birth of the bank account owner.\nThe date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).",
          "type": "string"
        },
        "ownerHouseNumberOrName": {
          "description": "The house name or number of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerName": {
          "description": "The name of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerNationality": {
          "description": "The country code of the country of nationality of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerPostalCode": {
          "description": "The postal code of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerState": {
          "description": "The state of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerStreet": {
          "description": "The street name of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "primaryAccount": {
          "description": "If set to true, the bank account is a primary account.",
          "type": "boolean"
        },
        "taxId": {
          "description": "The tax ID number.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "urlForVerification": {
          "description": "The URL to be used for bank account verification.\nThis may be generated on bank account creation.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ErrorFieldType": {
      "properties": {
        "errorCode": {
          "description": "The validation error code.",
          "format": "int32",
          "type": "integer"
        },
        "errorDescription": {
          "description": "A description of the validation error.",
          "type": "string"
        },
        "fieldType": {
          "description": "The type of error field.",
          "$ref": "#/$defs/FieldType"
        }
      },
      "type": "object"
    },
    "FieldType": {
      "properties": {
        "field": {
          "description": "The full name of the property.",
          "type": "string"
        },
        "fieldName": {
          "description": "The type of the field.",
          "enum": [
            "accountCode",
            "accountHolderCode",
            "accountHolderDetails",
            "accountNumber",
            "accountStateType",
            "accountStatus",
            "accountType",
            "address",
            "balanceAccount",
            "balanceAccountActive",
            "balanceAccountCode",
            "balanceAccountId",
            "bankAccount",
            "bankAccountCode",
            "bankAccountName",
            "bankAccountUUID",
            "bankBicSwift",
            "bankCity",
            "bankCode",
            "bankName",
            "bankStatement",
            "branchCode",
            "businessContact",
            "cardToken",
            "checkCode",
            "city",
            "companyRegistration",
            "constitutionalDocument",
            "controller",
            "country",
            "countryCode",
            "currency",
            "currencyCode",
            "dateOfBirth",
            "description",
            "destinationAccountCode",
            "document",
            "documentContent",
            "documentExpirationDate",
            "documentIssuerCountry",
            "documentIssuerState",
            "documentName",
            "documentNumber",
            "documentType",
            "doingBusinessAs",
            "drivingLicence",
            "drivingLicenceBack",
            "drivingLicenceFront",
            "drivingLicense",
            "email",
            "firstName",
            "formType",
            "fullPhoneNumber",
            "gender",
            "hopWebserviceUser",
            "houseNumberOrName",
            "iban",
            "idCard",
            "idCardBack",
            "idCardFront",
            "idNumber",
            "identityDocument",
            "individualDetails",
            "infix",
            "jobTitle",
            "lastName",
            "lastReviewDate",
            "legalArrangement",
            "legalArrangementCode",
            "legalArrangementEntity",
            "legalArrangementEntityCode",
            "legalArrangementLegalForm",
            "legalArrangementMember",
            "legalArrangementMembers",
            "legalArrangementName",
            "legalArrangementReference",
            "legalArrangementRegistrationNumber",
            "legalArrangementTaxNumber",
            "legalArrangementType",
            "legalBusinessName",
            "legalEntity",
            "legalEntityType",
            "logo",
            "merchantAccount",
            "merchantCategoryCode",
            "merchantHouseNumber",
            "merchantReference",
            "microDeposit",
            "name",
            "nationality",
            "originalReference",
            "ownerCity",
            "ownerCountryCode",
            "ownerDateOfBirth",
            "ownerHouseNumberOrName",
            "ownerName",
            "ownerPostalCode",
            "ownerState",
            "ownerStreet",
            "passport",
            "passportNumber",
            "payoutMethod",
            "payoutMethodCode",
            "payoutSchedule",
            "pciSelfAssessment",
            "personalData",
            "phoneCountryCode",
            "phoneNumber",
            "postalCode",
            "primaryCurrency",
            "reason",
            "registrationNumber",
            "returnUrl",
            "schedule",
            "shareholder",
            "shareholderCode",
            "shareholderCodeAndSignatoryCode",
            "shareholderCodeOrSignatoryCode",
            "shareholderType",
            "shareholderTypes",
            "shopperInteraction",
            "signatory",
            "signatoryCode",
            "socialSecurityNumber",
            "sourceAccountCode",
            "splitAccount",
            "splitConfigurationUUID",
            "splitCurrency",
            "splitValue",
            "splits",
            "stateOrProvince",
            "status",
            "stockExchange",
            "stockNumber",
            "stockTicker",
            "store",
            "storeDetail",
            "storeName",
            "storeReference",
            "street",
            "taxId",
            "tier",
            "tierNumber",
            "transferCode",
            "ultimateParentCompany",
            "ultimateParentCompanyAddressDetails",
            "ultimateParentCompanyAddressDetailsCountry",
            "ultimateParentCompanyBusinessDetails",
            "ultimateParentCompanyBusinessDetailsLegalBusinessName",
            "ultimateParentCompanyBusinessDetailsRegistrationNumber",
            "ultimateParentCompanyCode",
            "ultimateParentCompanyStockExchange",
            "ultimateParentCompanyStockNumber",
            "ultimateParentCompanyStockNumberOrStockTicker",
            "ultimateParentCompanyStockTicker",
            "unknown",
            "value",
            "verificationType",
            "virtualAccount",
            "visaNumber",
            "webAddress",
            "year"
          ],
          "type": "string"
        },
        "shareholderCode": {
          "description": "The code of the shareholder that the field belongs to. If empty, the field belongs to an account holder.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Transaction": {
      "properties": {
        "amount": {
          "description": "The amount of the transaction.",
          "$ref": "#/$defs/Amount"
        },
        "bankAccountDetail": {
          "description": "The details of the bank account to where a payout was made.",
          "$ref": "#/$defs/BankAccountDetail"
        },
        "captureMerchantReference": {
          "description": "The merchant reference of a related capture.",
          "type": "string"
        },
        "capturePspReference": {
          "description": "The psp reference of a related capture.",
          "type": "string"
        },
        "creationDate": {
          "description": "The date on which the transaction was performed.",
          "format": "date-time",
          "type": "string"
        },
        "description": {
          "description": "A description of the transaction.",
          "type": "string"
        },
        "destinationAccountCode": {
          "description": "The code of the account to which funds were credited during an outgoing fund transfer.",
          "type": "string"
        },
        "disputePspReference": {
          "description": "The psp reference of the related dispute.",
          "type": "string"
        },
        "disputeReasonCode": {
          "description": "The reason code of a dispute.",
          "type": "string"
        },
        "merchantReference": {
          "description": "The merchant reference of a transaction.",
          "type": "string"
        },
        "paymentPspReference": {
          "x-addedInVersion": "3",
          "description": "The psp reference of the related authorisation or transfer.",
          "type": "string"
        },
        "payoutPspReference": {
          "x-addedInVersion": "3",
          "description": "The psp reference of the related payout.",
          "type": "string"
        },
        "pspReference": {
          "description": "The psp reference of a transaction.",
          "type": "string"
        },
        "sourceAccountCode": {
          "description": "The code of the account from which funds were debited during an incoming fund transfer.",
          "type": "string"
        },
        "transactionStatus": {
          "description": "The status of the transaction.\n>Permitted values: `PendingCredit`, `CreditFailed`, `CreditClosed`, `CreditSuspended`, `Credited`, `Converted`, `PendingDebit`, `DebitFailed`, `Debited`, `DebitReversedReceived`, `DebitedReversed`, `ChargebackReceived`, `Chargeback`, `ChargebackReversedReceived`, `ChargebackReversed`, `Payout`, `PayoutReversed`, `FundTransfer`, `PendingFundTransfer`, `ManualCorrected`.",
          "enum": [
            "BalanceNotPaidOutTransfer",
            "BalancePlatformSweep",
            "BalancePlatformSweepReturned",
            "Chargeback",
            "ChargebackCorrection",
            "ChargebackCorrectionReceived",
            "ChargebackReceived",
            "ChargebackReversed",
            "ChargebackReversedCorrection",
            "ChargebackReversedCorrectionReceived",
            "ChargebackReversedReceived",
            "Converted",
            "CreditClosed",
            "CreditFailed",
            "CreditReversed",
            "CreditReversedReceived",
            "CreditSuspended",
            "Credited",
            "DebitFailed",
            "DebitReversedReceived",
            "Debited",
            "DebitedReversed",
            "DepositCorrectionCredited",
            "DepositCorrectionDebited",
            "Fee",
            "FundTransfer",
            "FundTransferReversed",
            "InvoiceDeductionCredited",
            "InvoiceDeductionDebited",
            "ManualCorrected",
            "ManualCorrectionCredited",
            "ManualCorrectionDebited",
            "MerchantPayin",
            "MerchantPayinReversed",
            "Payout",
            "PayoutReversed",
            "PendingCredit",
            "PendingDebit",
            "PendingFundTransfer",
            "ReCredited",
            "ReCreditedReceived",
            "SecondChargeback",
            "SecondChargebackCorrection",
            "SecondChargebackCorrectionReceived",
            "SecondChargebackReceived"
          ],
          "type": "string"
        },
        "transferCode": {
          "description": "The transfer code of the transaction.",
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}