Memo Bank PSD2 API documentation

Read transaction list of an account

GET /v1/accounts/{accountId}/transactions

O auth2

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

Headers

Signature string

Path parameters

accountId string(uuid) Required

Query parameters

bookingStatus string Required

Values are booked, pending, or both.
dateFrom string(date)
dateTo string(date)
withBalance boolean
orderBy string

Values are bookingDate or -bookingDate.

Default value is bookingDate.
page integer(int32)

Minimum value is 1. Default value is 1.
size integer(int32)

Minimum value is 1, maximum value is 100. Default value is 50.

Responses

• default object

default response
- account object
  iban string
  
  Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.
  
  currency string
  
  Format should match the following pattern: [A-Z]{3}.
  
  cashAccountType string
- balances array[object]
  balanceAmount object Required
  
  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
  
  referenceDate string(date)
- transactions object
  _links object
  
  account object Required
  
  href string
  
  first object
  
  href string
  
  next object
  
  href string
  
  previous object
  
  href string
  
  last object
  
  href string
  
  booked array[object]
  
  transactionAmount object Required
  
  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
  
  endToEndId string
  
  Minimum length is 0, maximum length is 35.
  
  batchIndicator boolean
  
  batchNumberOfTransactions integer(int32)
  
  mandateId string
  
  Minimum length is 0, maximum length is 35.
  
  bookingDate string(date)
  
  valueDate string(date)
  
  currencyExchange array[object]
  
  sourceCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  exchangeRate string Required
  
  unitCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  targetCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  quotationDate string(date) Required
  
  creditorName string
  
  Minimum length is 0, maximum length is 70.
  
  creditorAccount object
  
  iban string
  
  Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.
  
  currency string
  
  Format should match the following pattern: [A-Z]{3}.
  
  cashAccountType string
  
  creditorAgent string
  
  Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.
  
  debtorName string
  
  Minimum length is 0, maximum length is 70.
  
  debtorAccount object
  
  iban string
  
  Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.
  
  currency string
  
  Format should match the following pattern: [A-Z]{3}.
  
  cashAccountType string
  
  debtorAgent string
  
  Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.
  
  remittanceInformationUnstructured string
  
  Minimum length is 0, maximum length is 140.
  
  _extras object
  
  counterpartyAndRemittanceInformationUnstructured string
  
  Concatenates the counterparty name with the remittance information, to be used by consumers which only wants one field for both information.
  
  pending array[object]
  
  transactionAmount object Required
  
  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
  
  endToEndId string
  
  Minimum length is 0, maximum length is 35.
  
  batchIndicator boolean
  
  batchNumberOfTransactions integer(int32)
  
  mandateId string
  
  Minimum length is 0, maximum length is 35.
  
  bookingDate string(date)
  
  valueDate string(date)
  
  currencyExchange array[object]
  
  sourceCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  exchangeRate string Required
  
  unitCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  targetCurrency string Required
  
  Format should match the following pattern: [A-Z]{3}.
  
  quotationDate string(date) Required
  
  creditorName string
  
  Minimum length is 0, maximum length is 70.
  
  creditorAccount object
  
  iban string
  
  Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.
  
  currency string
  
  Format should match the following pattern: [A-Z]{3}.
  
  cashAccountType string
  
  creditorAgent string
  
  Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.
  
  debtorName string
  
  Minimum length is 0, maximum length is 70.
  
  debtorAccount object
  
  iban string
  
  Format should match the following pattern: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}.
  
  currency string
  
  Format should match the following pattern: [A-Z]{3}.
  
  cashAccountType string
  
  debtorAgent string
  
  Format should match the following pattern: [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}.
  
  remittanceInformationUnstructured string
  
  Minimum length is 0, maximum length is 140.
  
  _extras object
  
  counterpartyAndRemittanceInformationUnstructured string
  
  Concatenates the counterparty name with the remittance information, to be used by consumers which only wants one field for both information.

GET /v1/accounts/{accountId}/transactions

curl \
 -X GET https://api.memo.bank/nextgenpsd2/v1/accounts/{accountId}/transactions?bookingStatus=booked \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Signature: $SIGNATURE"

Response example (default)

{
  "account": {
    "iban": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "balances": [
    {
      "balanceAmount": {
        "currency": "string",
        "amount": "string"
      },
      "balanceType": "closingBooked",
      "creditLimitIncluded": true,
      "referenceDate": "2023-05-04"
    }
  ],
  "transactions": {
    "_links": {
      "account": {
        "href": "string"
      },
      "first": {
        "href": "string"
      },
      "next": {
        "href": "string"
      },
      "previous": {
        "href": "string"
      },
      "last": {
        "href": "string"
      }
    },
    "booked": [
      {
        "transactionAmount": {
          "currency": "string",
          "amount": "string"
        },
        "transactionId": "string",
        "endToEndId": "string",
        "batchIndicator": true,
        "batchNumberOfTransactions": 42,
        "mandateId": "string",
        "bookingDate": "2023-05-04",
        "valueDate": "2023-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2023-05-04"
          }
        ],
        "creditorName": "string",
        "creditorAccount": {
          "iban": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "creditorAgent": "string",
        "debtorName": "string",
        "debtorAccount": {
          "iban": "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": "2023-05-04",
        "valueDate": "2023-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2023-05-04"
          }
        ],
        "creditorName": "string",
        "creditorAccount": {
          "iban": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "creditorAgent": "string",
        "debtorName": "string",
        "debtorAccount": {
          "iban": "string",
          "currency": "string",
          "cashAccountType": "string"
        },
        "debtorAgent": "string",
        "remittanceInformationUnstructured": "string",
        "_extras": {
          "counterpartyAndRemittanceInformationUnstructured": "string"
        }
      }
    ]
  }
}