Read transactions list of an account

GET /v1/accounts/{accountId}/transactions

You can retrieve the full transactions history of an account, it is not limited to 180 days.

Path parameters

Query parameters

  • Values are booked, pending, or both. Default value is both.

  • dateFrom string(date)

    Filter transactions by booking date (inclusive greater than).

  • dateTo string(date)

    Filter transactions by booking date (exclusive lower than).

  • Default value is false.

  • orderBy string

    Values are bookingDate or -bookingDate.

    Default value is bookingDate.

Responses

  • default application/json

    default response

    Hide response attributes Show response attributes object
    • account object

      Additional properties are allowed.

      Hide account attributes Show account attributes object
      • iban string

        Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.

      • Minimum length is 0, maximum length is 35.

      • currency string

        Format should match the following pattern: [A-Z]{3}.

    • balances array[object]
      Hide balances attributes Show balances attributes object
      • balanceAmount object Required

        Additional properties are allowed.

        Hide balanceAmount attributes Show balanceAmount attributes object
        • currency string Required

          Format should match the following pattern: [A-Z]{3}.

        • amount string Required

          Format should match the following pattern: -?[0-9]{1,14}(\.[0-9]{1,3})?.

      • balanceType string Required

        Values are closingBooked, expected, openingBooked, interimAvailable, interimBooked, forwardAvailable, or nonInvoiced.

      • creditLimitIncluded boolean Required
      • referenceDate string(date) Required
    • Additional properties are allowed.

      Hide transactions attributes Show transactions attributes object
      • booked array[object]
        Hide booked attributes Show booked attributes object
        • transactionAmount object Required

          Additional properties are allowed.

          Hide transactionAmount attributes Show transactionAmount attributes object
          • currency string Required

            Format should match the following pattern: [A-Z]{3}.

          • amount string Required

            Format should match the following pattern: -?[0-9]{1,14}(\.[0-9]{1,3})?.

        • transactionId string Required
        • Minimum length is 0, maximum length is 35.

        • batchIndicator boolean Required
        • Minimum length is 0, maximum length is 35.

        • bookingDate string(date) Required
        • valueDate string(date) Required
        • currencyExchange array[object]
          Hide currencyExchange attributes Show currencyExchange attributes object
        • creditorName string Required

          Minimum length is 0, maximum length is 70.

        • Additional properties are allowed.

          Hide creditorAccount attributes Show creditorAccount attributes object
          • iban string

            Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.

          • Minimum length is 0, maximum length is 35.

          • currency string

            Format should match the following pattern: [A-Z]{3}.

        • Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.

        • Minimum length is 0, maximum length is 70.

        • Additional properties are allowed.

          Hide debtorAccount attributes Show debtorAccount attributes object
          • iban string

            Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.

          • Minimum length is 0, maximum length is 35.

          • currency string

            Format should match the following pattern: [A-Z]{3}.

        • Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.

        • Minimum length is 0, maximum length is 140.

        • _extras object Required

          Additional properties are allowed.

          Hide _extras attribute Show _extras attribute object
      • pending array[object]
        Hide pending attributes Show pending attributes object
        • transactionAmount object Required

          Additional properties are allowed.

          Hide transactionAmount attributes Show transactionAmount attributes object
          • currency string Required

            Format should match the following pattern: [A-Z]{3}.

          • amount string Required

            Format should match the following pattern: -?[0-9]{1,14}(\.[0-9]{1,3})?.

        • transactionId string Required
        • Minimum length is 0, maximum length is 35.

        • batchIndicator boolean Required
        • Minimum length is 0, maximum length is 35.

        • bookingDate string(date) Required
        • valueDate string(date) Required
        • currencyExchange array[object]
          Hide currencyExchange attributes Show currencyExchange attributes object
        • creditorName string Required

          Minimum length is 0, maximum length is 70.

        • Additional properties are allowed.

          Hide creditorAccount attributes Show creditorAccount attributes object
          • iban string

            Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.

          • Minimum length is 0, maximum length is 35.

          • currency string

            Format should match the following pattern: [A-Z]{3}.

        • Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.

        • Minimum length is 0, maximum length is 70.

        • Additional properties are allowed.

          Hide debtorAccount attributes Show debtorAccount attributes object
          • iban string

            Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.

          • Minimum length is 0, maximum length is 35.

          • currency string

            Format should match the following pattern: [A-Z]{3}.

        • Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.

        • Minimum length is 0, maximum length is 140.

        • _extras object Required

          Additional properties are allowed.

          Hide _extras attribute Show _extras attribute object
GET /v1/accounts/{accountId}/transactions
curl \
 --request GET https://api.memo.bank/nextgenpsd2/v1/accounts/{accountId}/transactions \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Signature: $SIGNATURE"
Response examples (default)
{
  "account": {
    "iban": "string",
    "maskedPan": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "balances": [
    {
      "balanceAmount": {
        "currency": "string",
        "amount": "string"
      },
      "balanceType": "closingBooked",
      "creditLimitIncluded": true,
      "referenceDate": "2025-05-04"
    }
  ],
  "transactions": {
    "_links": {
      "account": {
        "href": "string"
      },
      "next": {
        "href": "string"
      },
      "previous": {
        "href": "string"
      }
    },
    "booked": [
      {
        "transactionAmount": {
          "currency": "string",
          "amount": "string"
        },
        "transactionId": "string",
        "endToEndId": "string",
        "batchIndicator": true,
        "batchNumberOfTransactions": 42,
        "mandateId": "string",
        "bookingDate": "2025-05-04",
        "valueDate": "2025-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2025-05-04"
          }
        ],
        "creditorName": "string",
        "creditorAccount": {
          "iban": "string",
          "maskedPan": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "creditorAgent": "string",
        "debtorName": "string",
        "debtorAccount": {
          "iban": "string",
          "maskedPan": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "debtorAgent": "string",
        "remittanceInformationUnstructured": "string",
        "_extras": {
          "counterpartyAndRemittanceInformationUnstructured": "string"
        }
      }
    ],
    "pending": [
      {
        "transactionAmount": {
          "currency": "string",
          "amount": "string"
        },
        "transactionId": "string",
        "endToEndId": "string",
        "batchIndicator": true,
        "batchNumberOfTransactions": 42,
        "mandateId": "string",
        "bookingDate": "2025-05-04",
        "valueDate": "2025-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2025-05-04"
          }
        ],
        "creditorName": "string",
        "creditorAccount": {
          "iban": "string",
          "maskedPan": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "creditorAgent": "string",
        "debtorName": "string",
        "debtorAccount": {
          "iban": "string",
          "maskedPan": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "debtorAgent": "string",
        "remittanceInformationUnstructured": "string",
        "_extras": {
          "counterpartyAndRemittanceInformationUnstructured": "string"
        }
      }
    ]
  }
}