---
title: "POST /user/{userID}/transferwise-quote/{transferwise-quoteID}/transferwise-transfer"
method: POST
path: "/user/{userID}/transferwise-quote/{transferwise-quoteID}/transferwise-transfer"
tags: ["transferwise-transfer"]
---

# POST /user/{userID}/transferwise-quote/{transferwise-quoteID}/transferwise-transfer

`POST /user/{userID}/transferwise-quote/{transferwise-quoteID}/transferwise-transfer`

Used to create Transferwise payments.

## Path parameters

- `userID` integer, required
- `transferwise-quoteID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- TransferwiseTransfer
  - `monetary_account_id` string, required — The id of the monetary account the payment should be made from.
  - `recipient_id` string, required — The id of the target account.
  - `alias` LabelMonetaryAccount
    - `iban` string — The IBAN of the monetary account.
    - `display_name` string — The name to display with this monetary account.
    - `avatar` Avatar
      - `uuid` string — The public UUID of the avatar.
      - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
      - `image` Image[] — The actual image information of this avatar.
        - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
        - `content_type` string — The content-type as a MIME filetype.
        - `height` integer — The image height in pixels.
        - `width` integer — The image width in pixels.
      - `style` string — The style (if applicable) for this Avatar.
    - `label_user` LabelUser
      - `uuid` string — The public UUID of the label-user.
      - `display_name` string — The name to be displayed for this user, as it was given on the request.
      - `country` string — The country of the user. 000 stands for "unknown"
      - `avatar` Avatar
        - `uuid` string — The public UUID of the avatar.
        - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
        - `image` Image[] — The actual image information of this avatar.
          - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
          - `content_type` string — The content-type as a MIME filetype.
          - `height` integer — The image height in pixels.
          - `width` integer — The image width in pixels.
        - `style` string — The style (if applicable) for this Avatar.
      - `public_nick_name` string — The current nickname of the user.
    - `country` string — The country of the user. Formatted as a ISO 3166-1 alpha-2 country code.
    - `bunq_me` Pointer
      - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
      - `value` string — The alias value.
      - `name` string — The alias name.
      - `service` string — The pointer service. Only required for external counterparties.
    - `is_light` boolean — Whether or not the monetary account is light.
    - `swift_bic` string — The BIC used for a SWIFT payment.
    - `swift_account_number` string — The account number used for a SWIFT payment. May or may not be an IBAN.
    - `transferwise_account_number` string — The account number used for a Transferwise payment. May or may not be an IBAN.
    - `transferwise_bank_code` string — The bank code used for a Transferwise payment. May or may not be a BIC.
    - `merchant_category_code` string — The merchant category code.
  - `counterparty_alias` LabelMonetaryAccount
    - `iban` string — The IBAN of the monetary account.
    - `display_name` string — The name to display with this monetary account.
    - `avatar` Avatar
      - `uuid` string — The public UUID of the avatar.
      - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
      - `image` Image[] — The actual image information of this avatar.
        - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
        - `content_type` string — The content-type as a MIME filetype.
        - `height` integer — The image height in pixels.
        - `width` integer — The image width in pixels.
      - `style` string — The style (if applicable) for this Avatar.
    - `label_user` LabelUser
      - `uuid` string — The public UUID of the label-user.
      - `display_name` string — The name to be displayed for this user, as it was given on the request.
      - `country` string — The country of the user. 000 stands for "unknown"
      - `avatar` Avatar
        - `uuid` string — The public UUID of the avatar.
        - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
        - `image` Image[] — The actual image information of this avatar.
          - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
          - `content_type` string — The content-type as a MIME filetype.
          - `height` integer — The image height in pixels.
          - `width` integer — The image width in pixels.
        - `style` string — The style (if applicable) for this Avatar.
      - `public_nick_name` string — The current nickname of the user.
    - `country` string — The country of the user. Formatted as a ISO 3166-1 alpha-2 country code.
    - `bunq_me` Pointer
      - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
      - `value` string — The alias value.
      - `name` string — The alias name.
      - `service` string — The pointer service. Only required for external counterparties.
    - `is_light` boolean — Whether or not the monetary account is light.
    - `swift_bic` string — The BIC used for a SWIFT payment.
    - `swift_account_number` string — The account number used for a SWIFT payment. May or may not be an IBAN.
    - `transferwise_account_number` string — The account number used for a Transferwise payment. May or may not be an IBAN.
    - `transferwise_bank_code` string — The bank code used for a Transferwise payment. May or may not be a BIC.
    - `merchant_category_code` string — The merchant category code.
  - `status` string — The status.
  - `sub_status` string — The subStatus.
  - `status_transferwise` string — The status as Transferwise reports it.
  - `status_transferwise_issue` string — A status to indicatie if Transferwise has an issue with this payment and requires more information.
  - `amount_source` Amount
    - `value` string — The amount formatted to two decimal places.
    - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
  - `amount_target` Amount
    - `value` string — The amount formatted to two decimal places.
    - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
  - `rate` string — The rate of the payment.
  - `reference` string — The reference of the payment.
  - `pay_in_reference` string — The Pay-In reference of the payment.
  - `time_delivery_estimate` string — The estimated delivery time.
  - `quote` TransferwiseQuote
    - `currency_source` string, required — The source currency.
    - `currency_target` string, required — The target currency.
    - `amount_source` Amount
      - `value` string — The amount formatted to two decimal places.
      - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
    - `amount_target` Amount
      - `value` string — The amount formatted to two decimal places.
      - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
    - `id` integer — The id of the quote.
    - `created` string — The timestamp of the quote's creation.
    - `updated` string — The timestamp of the quote's last update.
    - `time_expiry` string — The expiration timestamp of the quote.
    - `quote_id` string — The quote id Transferwise needs.
    - `amount_fee` Amount
      - `value` string — The amount formatted to two decimal places.
      - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
    - `rate` string — The rate.
    - `time_delivery_estimate` string — The estimated delivery time.

## Response `200`

Used to create Transferwise payments.

- TransferwiseTransferCreate
  - `Id` BunqId
    - `id` integer — An integer ID of an object. Unique per object type.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/versions/369477c7bd26/schema)
