---
title: "Create multi transfer request"
method: POST
path: "/v2/requests/multi_transfers"
tags: ["Requests"]
---

# Create multi transfer request

`POST /v2/requests/multi_transfers`

OAuth scope: `request_transfers.write`

_This endpoint is accessible by organizations with all plans except Solo Basic._

---
Create a request of multi transfer that should be approved by a membership with permissions to review requests.

---
The response contains the created request.

## Headers

- `X-Qonto-Idempotency-Key` string, required
- `X-Qonto-Staging-Token` string

## Request body

- object
  - `request_multi_transfer` object, required
    - `note` string, required — Description of a nature of request. Helps approver to understand the reason of this request.
    - `transfers` object[], required
      - `amount` string, required — Should be decimal with 2 digits after coma, ex: "1", "1.99", "1.1"
      - `currency` string, required — ISO 4217 formatted. Can be either the currency of the debit_iban or the currency of the beneficiary. Allowed values: EUR
      - `credit_iban` string, required — International beneficiary Bank Account Identifier (IBAN) of creditor. Must respect ISO 13616.
      - `credit_account_name` string, required — Free format for the name of the beneficiary. Limited to 140 chars.
      - `credit_account_currency` string, required — ISO 4217 formatted. Can be either the currency of the debit_iban or the currency of the beneficiary. Allowed values: EUR
      - `reference` string, required — Reference of a transfer. Limited to 140 chars.
      - `attachment_ids` string[]
    - `scheduled_date` string, date — Date when all the transfers should be executed. Format: YYYY-MM-DD
    - `debit_iban` string — International beneficiary Bank Account Identifier (IBAN) of debitor. Must respect ISO 13616.

## Response `200`

Request multi transfer object

- object
  - `request_multi_transfer` object, required
    - `id` string, required
    - `request_type` string, required
    - `status` string, required
    - `initiator_id` string, required — ID of the membership that initiated the request. <br>When the request is initiated through the API, the initiator is the authenticated membership.
    - `approver_id` string, nullable
    - `note` string, required
    - `declined_note` string, nullable
    - `total_transfers_amount` string, required
    - `total_transfers_amount_currency` string, required
    - `total_transfers_count` integer, required
    - `scheduled_date` string, date
    - `processed_at` string, nullable
    - `created_at` string, required
    - `transfers` object[], required
      - `id` string, required
      - `credit_account_name` string, required
      - `amount` string, required
      - `currency` string, required
      - `reference` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Validation errors

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)