---
title: "Create internal transfer"
method: POST
path: "/v2/internal_transfers"
tags: ["Internal Transfers"]
---

# Create internal transfer

`POST /v2/internal_transfers`

OAuth scope: `internal_transfer.write`

---

Instant transfers between accounts of the same organization

---

This endpoint allows you to execute transfers between accounts of the same organization.

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.

---

You can obtain details for each organization account using [Show organization](/reference/openapi_v2.yml/paths/~1v2~1organizations~1%7Bid%7D/get)

---

## Request parameter details
<br/>

##### Amount and Currency
* The `amount` corresponds to the amount of the transaction in the `currency` of the bank account. Amounts must  be https://www.w3.org/TR/payment-request/#dfn-valid-decimal-monetary-value
* The `currency` field only accepts “EUR”
* More information: https://www.w3.org/TR/payment-request/#paymentcurrencyamount-dictionary
<br/>

##### Reference
* Transfer reference that can be used to enter transfer details to further describe the transfer
* Maximum `reference` length is `99` characters
<br/>

##### Side
* `credit_iban`: IBAN of account to credit
* `debit_iban`: IBAN of account to debit

## Headers

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

## Request body

- object
  - `internal_transfer` object, required
    - `debit_iban` string, required
    - `credit_iban` string, required
    - `reference` string, required
    - `amount` string, required
    - `currency` string, required

## Response `200`

returns a success status code

- object
  - `internal_transfer` object
    - `id` string — Transfer ID
    - `slug` string — Transfer slug
    - `status` string — Transfer status (always pending)
    - `amount` string — Transfer amount
    - `amount_cents` string — Transfer amount in cents
    - `currency` string — Transfer currency (EUR only)
    - `reference` string — Transfer reference
    - `created_at` string — Transfer creation time

## Other responses

- `400` — returns a bad request error
- `401` — returns an unauthorized error
- `403` — returns a forbidden error

---

[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/revisions/25208d6f9deb/schema)