# Initiate a wire transfer

**POST /v2/wire_transfers**

This endpoint allows you to initiate a wire transfer from your account.


## Servers
- Production: https://api.memo.bank (Production)
- Sandbox: https://api.sandbox.memo.bank (Sandbox)


## Authentication methods
- Jwt


## Parameters



## Body parameters
Content-type: application/json

- **instructed_amount** (integer(int64))
  Amount of the wire transfer, in the smallest unit of the instructed currency.
- **instructed_currency** (string)
  Currency of the wire transfer. An exchange rate will be applied if the currency differs from the currency of the local account.
- **local_iban** (string)
  Existing IBAN to be used as the source of the wire transfer. Can be the main IBAN of an account or a virtual IBAN.
- **beneficiary** (object)
  Information regarding the beneficiary of this wire transfer.
- **purpose** (string)
  Purpose of this wire transfer.
- **message** (string)
  Message attached to this wire transfer, visible to all involved parties.
- **internal_note** (string)
  Internal note attached to this wire transfer, visible only in your Memo Bank workspace.
- **custom_id** (string)
  Custom identifier that will be attached to the transaction resulting from this wire transfer. It will not be transmitted nor visible in your Memo Bank workspace. It can only be retrieved or used to search for transactions via Memo Bank API.
- **custom_metadata** (string)
  Custom metadata that will be attached to the transaction resulting from this wire transfer. It will not be transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.

## Responses
### 200: OK

#### Body Parameters: application/json (object)
- **id** (string(uuid))
  ID of the wire transfer
- **reference** (string(uuid))
  Unique reference, can be used to correlate with the resulting Transaction.
- **instructed_amount** (integer(int64))
  Amount of the wire transfer, in the smallest unit of the instructed currency.
- **instructed_currency** (string)
  Currency of the wire transfer, in ISO 4217 format.
- **account_id** (string(uuid))
  ID of the account this wire transfer belongs to, it can be missing while we process it according to the local IBAN.
- **local_iban** (string)
  IBAN used as a source of the wire transfer. It can be the main IBAN of an account or a virtual IBAN.
- **beneficiary_account_identifier** (object)
  Account identifier of the beneficiary.
- **message** (string)
  Message attached to this wire transfer, visible to all involved parties.
- **internal_note** (string)
  Internal note attached to this wire transfer, visible only in your Memo Bank workspace.
- **uetr** (string)
  Unique End-to-end Transaction Reference for this wire transfer. This allows you to track and trace the transaction through tools like Swift GPI.
- **custom_id** (string)
  Custom identifier attached to the transaction resulting from this wire transfer. It is not transmitted nor visible in your Memo Bank workspace. It can only be retrieved or used to search for transactions via Memo Bank API.
- **custom_metadata** (string)
  Custom metadata attached to the transaction resulting from this wire transfer. It is not transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.
- **status** (string)
  Current status of the wire transfer.
- **failure_code** (string)
  Code that represents the failure reason when the wire transfer has failed.


[Powered by Bump.sh](https://bump.sh)