Skip to content

Estimate withdrawal fees

GET
/api/managing-entity/{managingEntityIdentifier}/payment/withdrawal/estimate
curl --request GET \
--url 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/withdrawal/estimate?destinationIdentifier=3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51&destinationKind=BANK_ACCOUNT' \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Calculates the fee breakdown for a full-balance withdrawal to the chosen payout destination. Returns gross amount, transfer fee, FX fee (if applicable), and net payout amount. This is a read-only preview — no funds are moved and no withdrawal is initiated.

managingEntityIdentifier
required
string format: uuid
""

Managing entity identifier (UUID)

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
destinationIdentifier
required
string format: uuid
""

Identifier of the chosen BankAccount or RevolutPayoutAccount

Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51
destinationKind
required
string
""

Which collection on the managing entity to look up the destination in

Example
BANK_ACCOUNT
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Fee breakdown calculated successfully

Media type application/json

Fee breakdown preview for a withdrawal — no funds are moved.

object
grossAmount
required

Full available balance before any fees

number
""
transferFeeAmount
required

Revolut flat transfer fee ($5 USD converted to withdrawal currency)

number
""
fxFeeRate

FX exchange fee rate (0.006 or 0.010). Null if withdrawal currency is USD.

number | null
""
fxFeeAmount

Calculated FX exchange fee amount. Null if withdrawal currency is USD.

number | null
""
netAmount
required

Net amount the beneficiary would receive (grossAmount − transferFee − fxFee)

number
""
currencyCode
required

ISO 4217 currency code of the withdrawal

string
"" >= 1 characters /^[A-Z]{3}$/
offMarketHours

True if fees were computed during Revolut off-market hours (Fri 17:00 – Sun 18:00 Eastern)

boolean
key
additional properties
""
Example
{
"grossAmount": 5250.5,
"transferFeeAmount": 5,
"fxFeeRate": 0.006,
"fxFeeAmount": 31.5,
"netAmount": 5214,
"currencyCode": "USD",
"offMarketHours": false
}

Bad Request — missing or invalid request parameter or body

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example