Skip to content
Wink

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=e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18&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.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Managing entity identifier (UUID)

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

Query Parameters

Section titled “Query Parameters ”
destinationIdentifier
required
string
""

Identifier of the chosen BankAccount or RevolutPayoutAccount

Example 
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
destinationKind
required
string
""

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

Example 
BANK_ACCOUNT

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

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
offMarketHours

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

boolean
key
additional properties
""
Example

400

Section titled “400 ”

Invalid destination identifier or kind

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized — missing or invalid JWT token

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden — missing ACCOUNTING:READ permission

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

404

Section titled “404 ”

Managing entity or destination not found

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
offMarketHours

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

boolean
Example 
null

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}