Read transactions list of a card account

GET /v1/card-accounts/{accountId}/transactions

Path parameters

Query parameters

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

  • dateFrom string(date)

    Filter transactions by transaction date (inclusive greater than).

  • dateTo string(date)

    Filter transactions by transaction date (exclusive lower than).

  • orderBy string

    Values are transactionDate or -transactionDate.

    Default value is transactionDate.

Responses

  • default application/json

    default response

    Hide response attributes Show response attributes object
    • Hide cardAccount attributes Show cardAccount 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}.

    • Hide cardTransactions attributes Show cardTransactions attributes object
      • booked array[object]
        Hide booked attributes Show booked attributes object
      • pending array[object]
        Hide pending attributes Show pending attributes object
    • balances array[object]
      Hide balances attributes Show balances attributes object
      • balanceAmount object Required
        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
GET /v1/card-accounts/{accountId}/transactions
curl \
 -X GET https://api.memo.bank/nextgenpsd2/v1/card-accounts/{accountId}/transactions \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Signature: $SIGNATURE"
Response examples (default)
{
  "cardAccount": {
    "iban": "string",
    "maskedPan": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "debitAccounting": true,
  "cardTransactions": {
    "_links": {
      "cardAccount": {
        "href": "string"
      },
      "next": {
        "href": "string"
      },
      "previous": {
        "href": "string"
      }
    },
    "booked": [
      {
        "transactionAmount": {
          "currency": "string",
          "amount": "string"
        },
        "cardTransactionId": "string",
        "transactionDate": "2024-05-04",
        "bookingDate": "2024-05-04",
        "valueDate": "2024-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2024-05-04"
          }
        ],
        "originalAmount": {
          "currency": "string",
          "amount": "string"
        },
        "markupFee": {
          "currency": "string",
          "amount": "string"
        },
        "markupFeePercentage": "string",
        "cardAcceptorId": "string",
        "cardAcceptorAddress": {
          "country": "string",
          "townName": "string"
        },
        "merchantCategoryCode": "string",
        "maskedPAN": "string",
        "transactionDetails": "string"
      }
    ],
    "pending": [
      {
        "transactionAmount": {
          "currency": "string",
          "amount": "string"
        },
        "cardTransactionId": "string",
        "transactionDate": "2024-05-04",
        "bookingDate": "2024-05-04",
        "valueDate": "2024-05-04",
        "currencyExchange": [
          {
            "sourceCurrency": "string",
            "exchangeRate": "string",
            "unitCurrency": "string",
            "targetCurrency": "string",
            "quotationDate": "2024-05-04"
          }
        ],
        "originalAmount": {
          "currency": "string",
          "amount": "string"
        },
        "markupFee": {
          "currency": "string",
          "amount": "string"
        },
        "markupFeePercentage": "string",
        "cardAcceptorId": "string",
        "cardAcceptorAddress": {
          "country": "string",
          "townName": "string"
        },
        "merchantCategoryCode": "string",
        "maskedPAN": "string",
        "transactionDetails": "string"
      }
    ]
  },
  "balances": [
    {
      "balanceAmount": {
        "currency": "string",
        "amount": "string"
      },
      "balanceType": "closingBooked",
      "creditLimitIncluded": true,
      "referenceDate": "2024-05-04"
    }
  ]
}