# Create transfer transactions in bulk

Submit the details for the creation of a batch of Transfers.

The bulkId returned in the response can subsequently be used to launch the execution of the bulk process through Execute Bulk Process. A submitted bulk process can be managed (executed, accessed, paused, resumed and cancelled) by any Authorised User of the same identity of the user that submits the details.

The status of the bulk process after execution of this operation is set to ‘SUBMITTED’. The execution of the bulk process is launched through the Execute bulk process operation.

The submission of data for a bulk process does not expire but it can be cancelled through Cancel Bulk Process.

The system is configured to accept bulk requests to process up to a maximum of 10,000 bulk operations.

Each individual operation in this bulk will be processed via Create a Transfer Transaction.

Endpoint: POST /bulks/transfers
Version: 3.63.5
Security: auth_token, api-key

## Header parameters:

  - `idempotency-ref` (string)
    A unique call reference generated by the caller that, taking into consideration the payload as well as the operation itself, helps avoid duplicate operations. Idempotency reference uniqueness is maintained for at least 24 hours.

## Request fields (application/json):

  - `pathParams` (object)

  - `requestBody` (object)

  - `requestBody.profileId` (string, required)
    The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.

  - `requestBody.tag` (string)
    The tag field is a custom field that can be used to search and filter.

  - `requestBody.source` (object, required)
    The managed account or managed card from where the funds will be transferred.

  - `requestBody.source.id` (string, required)

  - `requestBody.source.type` (string, required)
    Enum: "managed_cards", "managed_accounts"

  - `requestBody.description` (string)
    The description details that are included in the transaction as reference.

  - `requestBody.destination` (object, required)
    The managed account or managed card to where the funds will be transferred.

  - `requestBody.destinationAmount` (object, required)
    The amount, in same currency as the source and destination instruments, to be transferred to the destination (exclusive of any fee amount that may be specified in the profile).

  - `requestBody.destinationAmount.currency` (string, required)
    The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

  - `requestBody.destinationAmount.amount` (integer, required)
    The monetary amount, scaled to the lowest denomination of the currency.

Example, an amount of 1000 for a EUR currency is actually 1000 Euro cents or EUR 10.00.

  - `requestBody.scheduledTimestamp` (string)
    The epoch timestamp at which the transaction is scheduled to be executed.

## Response 201 fields (application/json):

  - `bulkId` (string)

  - `operationCount` (integer)

  - `path` (string)