API Reference

Batch Transaction Details [coming soon] - only in Sandbox

The Batch Transaction Details API provides detailed transaction information for Credit Transfer and Direct Debit batches of a payment account. This enables you to enhance the audit and accounting processes of your clients by receiving detailed insights into batch transactions.

To use this API, you must subscribe to the Business Account Insight API. This is required to obtain the unique batch reference needed to retrieve batch transaction details using this API.

For more information, refer to the Rabo Banking Link manual for third parties.

Relevant scope(s) for oauth2 access code flow

Scope nameDescription
bai.batchtransactiondetails.readAllow read from Business Account Insight batch transaction details
📘

Make sure that you use the Authorization and Token URL as provided by the Authorization Services.

Rate Limiting

A default rate limit plan is set for all APIs. The rate limit can be shared or individual (defined per operation). The table below describes the rate limiting for this product.

OperationTypeLimit (API calls / s)Counts towards shared limit
GET /accounts/{account-id}/batch-details/{batch-entry-reference}Shared6Yes
All (premium) Oauth callsShared6Yes

Requests

The GET requests must contain a digital signature. You can generate this digital signature using the private key of your certificate. For the Sandbox environment, you can use an example certificate available in the Signing documentation.

To retrieve the transaction details of a specific batch for a payment account, your request must include both an account-id and a batch-entry-reference.

  • Before making request to batch endpoint, you must obtain the account-id by using the Read Account List endpoint of the Business Account Insight - Accounts API.
  • You can obtain the batch-entry-reference by using the Read Transactions endpoint of the Business Account Insight - Transactions API. To view the expected errors, refer to the Errors page in the Business Account Insight (BAI) documentation.
GET https://api.rabobank.nl/openapi/payments/insight/accounts/Wp-xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0/batchDetails/OM1B000000645364

Request with next page:

GET https://api.rabobank.nl/openapi/payments/insight/accounts/Wp- xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0/batchDetails/ OM1B000000645364?pageNumber=2

To view the full list of parameters, go to

  • GET/accounts/\{account-id}/batchDetails/\{batch-entry-reference}

Response

In the response, you receive a list of transactions for a specific batch.

Each response is paginated with a maximum of 500 transactions per page. You can use the pageNumber parameter to retrieve a next page of transactions for that batch.

The total number of transactions and the corresponding amount for the batch should match the booking returned by the Business Account Insight - Transactions API. Any rejections are booked as separate return bookings and are not be visible in this response.

{
  "batchEntryReference": "OM1B000000645364",
  "paymentInformationIdentification": "123456",
  "numberOfTransactions": "550",
  "authorisationUserName": "Alphanumeric 140",
  "categoryPurposeCode": "SALA",
  "batchAmount": {
    "value": "55000",
    "currency": "EUR"
  },
  "batchType": "CT",
  "requestedExecutionDate": "2024-05-23T06:48:11.607486Z",
  "next": "/accounts/hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA/batchDetails/OM1B000000645364?pageNumber=2",
  "transactionDetails": [
    {
      "endToEndId": "90705030",
      "transactionAmount": {
        "amount": 5.12,
        "currency": "EUR"
      },
      "remittanceInformationStructured": "23183510990000",
      "remittanceInformationUnstructured": "Unstructured-02-IPIV4TC08C01-1844251",
      "creditorAccount": {
          "currency": "EUR",
          "iban": "NL52RABO0125618484"
      },
      "creditorAgent": "RABONL2UXXX",
      "creditorName": "Creditor Name",
      "ultimateCreditor": "Ultimate Creditor",
      "debtorAccount": {
          "currency": "EUR",
          "iban": "NL52RABO0125618484"
      },
      "debtorAgent": "RABONL2UXXX",
      "debtorName": "Debtor Name",
      "ultimateDebtor": "Ultimate Debtor"
    }
  ]
}

Account-id and batchEntryReference scenario's present in the Sandbox environment:

IBANaccount-idbatchEntryReferenceNoOfTransactions
NL52RABO0125618484Wp-xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0OM1B000000645366250
NL80RABO1127000002hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bAOM1B0000006453651500
NL80RABO1127000002hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bAOM1B000000645364550