Transfers

Get an indicative quote for a transfer

Get a non-binding estimate of fees, the exchange rate, and the expected delivery time for a potential transfer. No money is moved and no resource is created.

The request mirrors the /pay endpoint that is used to initiate a transfer, but it excludes irrelevant fields that do not affect pricing or delivery time, such as the request ID or reference.

If the counterparty has multiple payment methods available, for example, 2 accounts, or 1 account and 1 card, you must specify the account or card to which you want to transfer the money (receiver.account_id or receiver.card_id respectively). Note that in a single request, you can specify either an account or a card, but not both.

:::note[Sandbox behaviour] In Sandbox, this feature is only available for testing. While incomplete or invalid requests will return production-like error responses, complete and valid requests in Sandbox do not return real values and estimated_arrival will always return instant. :::

For more details, see the guides: Check costs and delivery time before paying section in Bank transfers or Card transfers.

post/pay/indicative-quote

Request

  • Base URL
    https://b2b.revolut.com/api/1.0
  • Auth
    HTTP bearer

Request body

account_idstring uuid required

The ID of the account from which the transfer will be made.

amountnumber double required

The transfer amount in major units.

currencystring required

ISO 4217 currency code in upper case.

charge_bearer'shared' | 'debtor' | 'prefer_debtor'

The party to which any transaction fees are charged if the resulting transaction route has associated fees:

ValueDescription
sharedAlso known as SHA. The transaction route fees are split between the sender and the recipient. The sender pays the fees charged by their bank, while the recipient pays the fees charged by the receiving and any intermediary banks.
debtorAlso known as OUR. The sender pays all explicit transaction fees.
prefer_debtorSelects the SWIFT OUR option when available. If the payment doesn't offer the OUR option, this value is ignored and the default fee handling applies — no error 3287 is returned.

:::note Some transactions with fees might not support forced charge bearer selection. If this is the case, the request will return an error. This does not apply to prefer_debtor, which falls back to default if debtor is not available. :::

transfer_reason_codestring

The reason code for the transaction. Transactions to certain countries and currencies might require you to provide a transfer reason. You can check available reason codes with the GET /transfer-reasons operation.

If a transfer reason is not required for the given currency and country, this field is ignored.

exchange_reason_codestring

The reason code for the exchange. Depending on the country and the amount of funds to be exchanged, you might be required to provide an exchange reason. You can check available reason codes with the GET /exchange-reasons operation.

If an exchange reason is not required, this field is ignored.

Example request

{
  "transfer_reason_code": "property_rental",
  "exchange_reason_code": "fund_transfer_and_intracompany_payment"
}

Response

The expected processing attributes for the potential transfer

estimated_exchange_ratestring

Exchange rate for the transfer.

For same-currency transfers, this field is omitted from the response.

warningsstring[]

Potential warnings regarding the quote:

ValueDescription
volatile_fx_rateReturned when the specified FX rate is volatile.

Changes

No recorded changes to this operation across all 1 revision of this API.