Requests
Create multi transfer request
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.
post/v2/requests/multi_transfers
Headers
X-Qonto-Idempotency-Keystring required
The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. The idempotency key must be a unique string. We recommend using a UUID.
X-Qonto-Staging-Tokenstring
Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.
Request body
Example request
{
"request_multi_transfer": {
"note": "Salary of marketing departmenet. Please approve ASAP.",
"transfers": [
{
"amount": "2000.50",
"currency": "EUR",
"credit_iban": "FR7630001007941234567890183",
"credit_account_name": "URSSAF",
"credit_account_currency": "EUR",
"reference": "Invoice 2023-01",
"attachment_ids": [
"d840f1cb-6adb-48af-9f89-540dcf5ba741"
]
}
],
"scheduled_date": "2023-03-06",
"debit_iban": "FR0807277000000000000000911"
}
}Response
Request multi transfer object
Example response
{
"request_multi_transfer": {
"id": "bb8f8d1d-5f12-486e-8f8e-90cc2af76038",
"request_type": "multi_transfer",
"status": "pending",
"initiator_id": "6b1872e4-08e4-42ec-9c82-b441ec242a9b",
"note": "Salary of marketing departmenet. Please approve ASAP",
"total_transfers_amount": "2000.50",
"total_transfers_amount_currency": "EUR",
"total_transfers_count": 1,
"scheduled_date": "2023-03-06",
"created_at": "2023-02-16T17:33:38.215Z",
"transfers": [
{
"id": "d840f1cb-6adb-48af-9f89-540dcf5ba741",
"credit_account_name": "URSSAF",
"amount": "2000.50",
"currency": "EUR",
"reference": "Invoice 2023-01"
}
]
}
}