---
title: "Create account to account batch transfer"
method: POST
path: "/v1/a2a/batches"
tags: ["Account to account batch transfer"]
---

# Create account to account batch transfer

`POST /v1/a2a/batches`

Please note that this feature requires manual configuration. If you want to use it, please contact your CSM.

This operation will create a batch transfer with the given transfer items.

## Query parameters

- `auditUser` string, required

## Request body

- AccountToAccountBatchTransferRequest
  - `description` string — Free form description.
  - `transfers` AccountToAccountTransferRequest[], required — An array of transfer requests
    - `fromAccountId` string, biginteger, required — Id of account from which balance will be debited
    - `toAccountId` string, biginteger, required — Id of account from which balance will be credited
    - `amount` number, required — Transfer amount. It is possible to post only amount which is equal or more than minimal currency unit (For example, for EUR, SEK, NOK minimal unit is 0,01)
    - `currency` string, required — Currency of the amount in ISO 4217 (Alpha code) format. Currency has to be the same as account currency. Balance transfer can only be done between accounts that are in the same currency, i.e. currency conversion is not supported.
    - `text` string — Free form text. Text is available in Transaction API as well as Data export transaction files.

## Response `200`

Successful creation of batch transfer

- CreateBatchTransferResponse
  - `id` string, required — Enfuce generated id for batch transfer.
  - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_ERRORS', required — Batch transfer status. `IN_PROGRESS` - Successfully created but not yet complited batch transfer. `COMPLETED` - Successfully completed batch transfer. `FAILED` - Completely or partially failed batch transfer.
  - `description` string — Free form description.
  - `startTime` string, date-time, required
  - `transferItemCount` integer, required — Number of transfer items in the batch.
  - `totalAmount` object — Map of total amount per currency.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — API is having problems

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)