07 Transactions

Transaction history

• returns data normally for up to 2 years
• if you don't fill in the fromDate and toDate parameters, the transaction history is returned only for 90 days from today.

Important

• Pairing transactions in the state PDNG -> BOOK can be done using the references.accountServicer attribute. It is the same for both transaction statuses.
• use the accountServicer attribute as a unique payment identifier. This will provide you with a connection in the payment lifecycle

Limits

• time limit to start download next page is 10 sec
• limit for download is one per hour, if you want download more try Continue to Notification...
• maximum is 100 transaction on page - parameter size

Request

curl --location --request GET 'https://api-gateway.kb.cz/adaa/v1/accounts/Zm9PTlRTeFppV3N3eERxOUVueEE2Y2xYUU5NbGg3NSthUktwUzhzcGE5MW42USs1cmlUbWZGNkM2aXp1MDROaE1sV2p5UDVlbEdxYWxFejRtdkNqQ1E9PQ/transactions?fromDate=2022-01-15&toDate=2022-03-05&size=100&page=0' \
--header 'x-correlation-id: 6d745f4e-eb52-441a-a1e3-86f82619ab83' \
--header 'apiKey: 3a7f779a-8cc1-364f-be2b-9ea161f63817' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiOiJ3RjJTa1I3NWMxamZsZ1VIOWJ6Wno3Tzllemc9IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJBUElJRD01MmYwNDgyNjM3OTM0ZGZmOWY5MjE1MTBhMjlhMWYwYSIsImN0cyI6Ik9BVVRIMl9TVEFURUxFU1NfR1JBTlQiLCJhdXRoX2xldmVsIjo2LCJhdWRpdFRyYWNraW5nSWQiOiIwN2UyZjk4NC0zNTJjLTQ1ZmItYTk5MC0yOGEzZTI3NDA2MmUtMzE4OTk5MTUiLCJpc3MiOiJodHRwczovL2NhYXMua2IuY3ovb3BlbmFtL29hdXRoMiIsInRva2VuTmFtZSI6ImFjY2Vzc190b2tlbiIsInRva2VuX3R5cGUiOiJCZWFyZXIiLCJhdXRoR3JhbnRJZCI6IjF1bzJ1ZHNjS0dLSWQwVjFFT2ZzRW1sUUtQcyIsImF1ZCI6IktpZmxpLTE2MzUiLCJuYmYiOjE2NTU3MzA3MzAsImdyYW50X3R5cGUiOiJyZWZyZXNoX3Rva2VuIiwic2NvcGUiOlsiYWRhYSJdLCJhdXRoX3RpbWUiOjE2NTUzNzcyNzMsInJlYWxtIjoiLyIsImV4cCI6MTY1NTczMDkxMCwiaWF0IjoxNjU1NzMwNzMwLCJleHBpcmVzX2luIjoxODAsImp0aSI6InJWZERFQktFR2dMbjVCQk9RTjRIY3F5Y1k4YyIsImNhYXNPcGVyYXRpb25JZCI6IjUyNzYyMTc3NmRiODQ0MTg5MGJjM2MzM2RkZjYzYmVlIn0.r26PDIs4uuVGrmECIkQqM16lDL2a-XEWvfJOqMJVA8zHfFEDmLQ3VRj4nOiXjfp4uwQQUVTSzYaMkNw4BGsCtxRRvk54pFgCcl8GtSlfhL44cMA3mtZuEx39tqsdndymvPE6U9-wP5nzzeFJdZsOeAbzAGgIwWTNcUSH6YlbQLkuH-Z4qVnVCVwwspzEupJsgnRGYuDVzhk0BP4eDzF12fdRx7Zq2cCGY0H89XwWrf7GBpZQubzZgACle8r1oOR86_65Wwd88oNo5HUfC_kKGyYL-lhMIGbcbMGf5SX1Te7PPBAy9q2BQnRhcpIunvGKSv_aAiFOW9DMLWgUT6vPhA'

Response

{
  "content": [
    {
      "lastUpdated": "2022-06-16T11:10:00.336259Z",
      // date and time when you download from API
      
      "accountType": "KB",
      // type of account, currently only KB
      
      "entryReference": "120-20210222 T02AR0H7AB803",
      // Payment identification number assigned by the bank.
      // Not unique, please use references.accountServicer
      
      "iban": "CZ0301000001158830140287",
      // IBAN of the account from which the data is downloaded

      "creditDebitIndicator": "CREDIT",
      // An indication of whether it is a debit payment or a credit payment on the account. 
      // Allowed values:
      //  - DEBIT: Debit transactions humiliating balance given account.
      //  - CREDIT: Credit transactions increasing the balance of a given account.

      "transactionType": "DOMESTIC",
      // DOMESTIC, FOREIGN, FEE, CASH, OTHER

      "bankTransactionCode": {
        "code": "10000107000",
        // codebook : https://mojebanka.kb.cz/file/cs/format_xml_vypis_ciselnik_trn.pdf

        "issuer": "CBA"
        // currently only CBA
      },
      "amount": {
        "value": 4000.0,
        // Payment amount in the currency of the account

        "currency": "CZK"
        // Currency of payment, CurrencyCode ISO 4517
      },
      "bookingDate": "2021-02-23",
      // Date of booking payments by bank in format ISODate
      "valueDate": "2021-02-23",
      // Due date/currencies payments in format ISODate, i.e. YYYY-MM-DD
      "instructed": {
        "value": 4000.0,
        // Original amount  of the payment that was requested by the client transfer.

        "currency": "CZK"
        // Original the currency of the payment that was requested by the client transfer, CurrencyCode ISO 4517
      },
      "status": "BOOK",
      // Item status (written off or credited payments) on account from the bank's perspective.
      // Allowed values:
      // - BOOK: posted items
      // - PDNG: blocked items
      

      "counterParty": {
        "iban": "CZ2962106701002201598706",
        // Beneficiary's account number in international format IBAN account numbers.
        "name": "KATERINA NOVAKOVA",
        // Name of the counterparty
        "accountNo": "6701002201598706",
        // Counterparty account number
        "bankBic": "BREXCZPPXXX",
        // BIC of the counterparty bank
        "bankCode": "6210"
        // Counterparty bank code
      },
      "references": {
        "accountServicer": "311892adb7f2b601",
        // Bank unique references associated with the payment,

        "receiver": "PLATBA"
        // Message to recipients
      },
      "additionalTransactionInformation": "Ach deposit"
      // Not relevant yet
    },
    {
      "lastUpdated": "2024-03-11T13:14:14.97013Z",
      "accountType": "KB",
 
      "entryReference": "PCOG3COLBEACCEGFLLMRFXSPY7U36MJ5BJVSBBYQCCAI5ZCI3POZB2XETCMC27KPWKBGEKTWTH6H2XDMJ5FRBAY",
      // Payment identification number assigned by the bank.
      // Not unique, please use references.accountServicer
      "iban": "CZ5401000001154933990227",

      "creditDebitIndicator": "DEBIT",
      "transactionType": "CARD",

      "bankTransactionCode": {
          "code": "30000201000",
          "issuer": "CBA"

      },
      "amount": {
          "value": 208.0,
          "currency": "CZK"
      },
      "valueDate": "2024-03-11",
      "instructed": {
          "value": 208.0,
          "currency": "CZK"
      },
      "status": "PDNG",
      // Item status (written off or credited payments) on account from the bank's perspective.
      // Allowed values:
      // - BOOK: posted items
      // - PDNG: blocked items
      //   - In the following days, the transaction with the BOOK status will arrive and the transaction with the PDNG status will disappear.
      "counterParty": {
          "name": "Alza.cz a.s."
      },
      "references": {
          "accountServicer": "484071474337311",
          "variable": "15606922"
      },
      "additionalTransactionInformation": "477975XXXXXX8489",
      // Masked PAN.
      "cardTransactionDetails": {
        // More information about the card transaction. This section is for card transactions only.
          "holdExpirationDate": "2024-03-20"
          // Information on the latest date for cancelling the block on the card
      }
  }
    {
      "lastUpdated": "2022-06-16T11:10:00.336367Z",
      "accountType": "KB",
      "entryReference": "362-02042021 1602 602105 100070",
      "iban": "CZ0301000001158830140287",
      "creditDebitIndicator": "DEBIT",
      "transactionType": "DOMESTIC",
      "bankTransactionCode": {
        "code": "10000108000",
        "issuer": "CBA"
      },
      "amount": {
        "value": 2000.0,
        "currency": "CZK"
      },
      "bookingDate": "2021-04-04",
      "valueDate": "2021-04-04",
      "instructed": {
        "value": 2000.0,
        "currency": "CZK"
      },
      "status": "BOOK",
      "counterParty": {
        "iban": "CZ0208000000002795161113",
        "accountNo": "0000002795161113",
        "bankBic": "GIBACZPXXXX",
        "bankCode": "0800"
      },
      "references": {
        "accountServicer": "2a298af7ee51cdff"
      },
      "additionalTransactionInformation": "Force pay debit, OI00014M3AZ"
    }
  ],
  "totalPages": 3,
  // Total number of pages
  "pageNumber": 0,
  // Current page
  "pageSize": 100,
  // Number of entries per page, maximum is 20.
  "numberOfElements": 20,
  // Actual number of entries on the page.
  "first": true,
  // If this first page is true, otherwise false
  "last": false,
  // If this last page is true, otherwise false
  "empty": false
  // If no records are returned is true, otherwise false
}

---

Continue to Notification...