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 name	Description
bai.batchtransactiondetails.read	Allow 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.

Operation	Type	Limit (API calls / s)	Counts towards shared limit
`GET /accounts/{account-id}/batch-details/{batch-entry-reference}`	Shared	6	Yes
All (premium) Oauth calls	Shared	6	Yes

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/batch-details/OM1B000000645364

Request with next page:

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

To view the full list of parameters, go to

GET /account/{account-id}/batch-details/{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": "Signer 2",
  "authorisationHistory": [
            {
             "authorisationUserName": "Signer 1",
             "authorisationDateTime": "2024-05-24T06:48:11.607486Z"
            },
            {
              "authorisationUserName": "Signer 2",
              "authorisationDateTime": "2024-05-25T06:48:11.607486Z"
            }
          ],
  "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:

IBAN	account-id	batchEntryReference	NoOfTransactions
NL52RABO0125618484	Wp-xhZMGEWRIIgVjPwTC1aKJJ0VCRZ_4bScUVXof7e0	OM1B000000645366	250
NL80RABO1127000002	hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA	OM1B000000645365	1500
NL80RABO1127000002	hBS4MQ0Oc4LLJRiUiE_R94_-zoU4B2vwnPkXmsGh_bA	OM1B000000645364	550