---
title: "Create Bulk Transfer"
method: POST
path: "/v2/transfers/bulk"
---

# Create Bulk Transfer

`POST /v2/transfers/bulk`

Use this API to create a bulk transfer.

## Request body

- object
  - `type` string, required — Type of bulk transfer you want to create.<br><br>Possible values: <ul><li>`account_number`</li>
  - `debit_account_id` string, required — The `account_id` from which money should be debited.<br><br>**Note**: Currently, you can only use a virtual account used as a transfer wallet as a debit account.<br><br>Example: `va_thdScysrIYcT7R5X1NuMhbRNH`
  - `transfers` object[], required — Array of objects that contains the details of the individual transfers you want to perform.
    - `beneficiary_details` object — An object that contains the beneficiary details.
      - `name_of_account_holder` string, required — Beneficiary's name.<br><br>Supported characters: <ul><li>`a-z`</li><li>`A-Z`</li><li>`0-9`</li><li>`space`</li><li>`’`</li><li>`-`</li><li>`_`</li><li>`/`</li><li>`(`</li><li>`)`</li><li>`.`</li><li>`&`</li><li>`#`</li><li>`$`</li><li>`@`</ul></li>Example: `Anil Reddy`
      - `bank_account_number` string, required — Beneficiary's bank account number.<br><br>Example: `98765432101234`
      - `bank_ifsc_code` string, required — Beneficiary's bank IFSC.<br><br>Example: `HDFC0000123`
      - `vpa` string, required — Required when type is vpa
    - `amount` number, float, required — The amount you want to transfer in Rs.<br><br>Example: `369.61`
    - `payment_mode` string, required — The mode to be used to make the transfer.<br><br>Possible values:<ul><li>`neft`<li>`imps` <li>`rtgs`</li><li>`upi`</li></ul>
    - `currency_code` string — ISO code of the currency in which you want to make the transfer.<br><br>Has to be 3 letters.<br><br>Currently, only `inr` is allowed.<br><br>Example: `inr`
    - `payment_remark` string — Enter a remark for the transfer. This is shown in the bank statement.<br><ul><li>Only alphabets and numbers are allowed.</li><li>Minimum: 1 character.</li><li>Maximum: 40 characters.</li></ul>Example: `Payment using Zwitch.`
    - `merchant_reference_id` string, required — Unique identifier entered when creating the individual transfer.<br><ul><li>Only alphabets and numbers are allowed.</li><li>Minimum: 7 characters.</li><li>Maximum: 40 characters.</li></ul>Example: `1409614085`<br><br>**Note**: This ID should be unique for each transfer of the bulk request.
    - `metadata` object — Key-value pair that can be used to store additional information about the entity.<br><br>Note:<ul><li>Maximum 5 key-value pairs. </li><li>Maximum 256 characters in the `metadata` object.</li><li>You cannot pass a URL.</li><li>You cannot use `\`.</li></ul>Example: `"key_1": "DD"`
      - `key_1` string
      - `key_2` string
  - `bulk_reference_id` string, required — Unique reference for the bulk transfer request set by you. <ul><li>Only alphabets and numbers are allowed.</li><li>Minimum: 7 characters.</li><li>Maximum: 40 characters.</li></ul>Example: `1234567890123`

## Response `200`

200

- object
  - `id` string
  - `object` string
  - `type` string
  - `status` string
  - `debit_account_details` object
    - `name` string
    - `account_number` string
    - `ifsc` string
  - `total_individual_transfers` integer
  - `total_transfer_amount` integer
  - `bulk_reference_id` string
  - `updated_at` integer
  - `is_sandbox` boolean
  - `created_at` integer

## Other responses

- `401` — 401
- `422` — 422

---

[API](https://skmtc.net/zwitch/apis/2.md) · [All operations](https://skmtc.net/zwitch/apis/2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zwitch/2/versions/4586157daf87/schema)