Sign in
SEPA Credit Batch Transfers

Create a Batch Transfer

Creates a batch transfer for the account specified in the request URL.<br /> Note: This call triggers the change request process.

post/v1/accounts/{account_id}/batch_transfers

Path parameters

account_idstring required

The ID of the account to create a batch transfer for.

Request body

transfer_type'SCT' | 'SCT_INSTANT' required

The type for all transfers of the batch.

referencestring required

A reference for the batch transfer.

descriptionstring

A description for the batch transfer.

Example request

{
  "transfer_type": "SCT_INSTANT",
  "reference": "12f7ec0b-6762-4578-b49f-c0b1647d0e2d",
  "description": "Monthly Salary Payments",
  "transfers": [
    {
      "creditor_iban": "DE87110101001000057123",
      "creditor_name": "Hans Mustermann",
      "amount": {
        "value": 1000,
        "currency": "EUR"
      },
      "description": "Salary Payment",
      "end_to_end_id": "e2178fc8b9ad4a479e269a47f90b4a43",
      "initiator_reference": "2603037c-e264-46c4-82e8-0d3ebc23a30f",
      "verification_of_payee_id": "1234567890abcdef1234567890abcdefvop"
    }
  ]
}

Response

The change request was successfully confirmed, and the batch transfer was accepted.

idstring

Unique ID of the batch transfer.

account_idstring

The account ID of the account that the batch transfer is associated with.

status'AUTHORIZATION_REQUIRED' | 'ACCEPTED' | 'REJECTED' | 'IN_PROGRESS' | 'FINISHED'

The status of the batch transfer.

transfer_type'SCT' | 'SCT_INSTANT'

The type for all transfers of the batch.

referencestring

A reference for the batch transfer.

descriptionstring

Optional description for the batch.

total_amountnumber

The total amount of all planned transfers in the batch in cents.

created_atstring date-time

UTC timestamp when the batch transfer was created.

started_atstring date-time

UTC timestamp when the batch transfer started the processing of all their transfers.

finished_atstring date-time

UTC timestamp when all transfers were processed and the status of the batch reached FINISHED.

updated_atstring date-time

UTC timestamp when the batch transfer was updated the last time.

Example response

{
  "id": "f874b3102718a4d757a6b6e4d5996078sctb",
  "account_id": "236f9042a19b65c0867e10c922b93502cacc",
  "status": "ACCEPTED",
  "transfer_type": "SCT_INSTANT",
  "reference": "12f7ec0b-6762-4578-b49f-c0b1647d0e2d",
  "description": "Monthly Salary Payments",
  "total_amount": 1000,
  "transfers_summary": {
    "executed": 9,
    "failed": 1
  },
  "created_at": "2025-04-01T13:59:52+00:00",
  "started_at": "2025-04-01T14:01:00+00:00",
  "finished_at": "2025-04-01T14:10:30+00:00",
  "updated_at": "2025-04-01T14:10:30+00:00"
}