---
title: "Create a Batch Transfer"
method: POST
path: "/v1/accounts/{account_id}/batch_transfers"
tags: ["SEPA Credit Batch Transfers"]
---

# Create a Batch Transfer

`POST /v1/accounts/{account_id}/batch_transfers`

Creates a batch transfer for the account specified in the request URL.<br /> **Note**: This call triggers the [change request](https://docs.solarisgroup.com/guides/digital-banking/strong-customer-authentication/#change-request-process) process.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `transfer_type` 'SCT' | 'SCT_INSTANT', required — The `type` for all transfers of the batch.
  - `reference` string, required — A reference for the batch transfer.
  - `description` string — A description for the batch transfer.
  - `transfers` object[], required — List of transfers to be processed as part of the batch.
    - `creditor_iban` string, required — The recipient's IBAN.
    - `creditor_name` string, required — The recipient's name.
    - `amount` Money, required
      - `value` integer — Amount described in smallest currency unit (e.g. cents).
      - `currency` string — The currency of the given value. Only EUR is currently supported.
    - `description` string — Description for the transaction, which will be visible to the recipient. Limited to 140 characters.
    - `end_to_end_id` string — Transfer's transaction EndToEnd ID for later identification.
    - `initiator_reference` string — A unique reference for the transfer.
    - `verification_of_payee_id` string — The ID of a Verification of Payee that must be completed before making this transaction request. This verification confirms the recipient's identity and bank details.

## Response `201`

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

- BatchTransfer
  - `id` string — Unique ID of the batch transfer.
  - `account_id` string — 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.
  - `reference` string — A reference for the batch transfer.
  - `description` string — Optional description for the batch.
  - `total_amount` number — The total amount of all **planned** transfers in the batch in cents.
  - `transfers_summary` object — Summary of executed and failed transfer counts within the batch.
    - `executed` number — Number of transfers in the batch which were executed (successfully).
    - `failed` number — Number of transfers in the batch which failed (not successful).
  - `created_at` string, date-time — UTC timestamp when the batch transfer was created.
  - `started_at` string, date-time — UTC timestamp when the batch transfer started the processing of all their transfers.
  - `finished_at` string, date-time — UTC timestamp when all transfers were processed and the status of the batch reached `FINISHED`.
  - `updated_at` string, date-time — UTC timestamp when the batch transfer was updated the last time.

## Other responses

- `202` — The request is accepted, and the customer must confirm the change request.
- `400` — Invalid request.
- `403` — You are not authorized to perform this action.
- `404` — The resource could not be found.
- `500` — Internal server error.
- `default` — Unexpected error

---

[API](https://skmtc.net/solarisgroup/apis/sepa-transfers.md) · [All operations](https://skmtc.net/solarisgroup/apis/sepa-transfers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/sepa-transfers/revisions/f1fef352d976/schema)