Skip to content
Wink

Withdrawal history

GET
/api/managing-entity/{managingEntityIdentifier}/payment/withdrawal
 
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns all withdrawal records for the given managing entity, ordered most recent first. Includes full fee breakdowns and status for each withdrawal.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string format: uuid
""

Managing entity identifier (UUID)

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

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 ”

Withdrawal history retrieved successfully; results ordered most recent first

Media type application/json
Array<object>

TripPay beneficiary withdrawal (payout) to a bank account via Revolut.

object
id

Document UUID

string format: uuid
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.

integer format: int64
""
accountIdentifier
required

TripPay account identifier of the beneficiary requesting withdrawal

string format: uuid
"" >= 1 characters
bankAccountIdentifier
required

BankAccount identifier within the account

string format: uuid
"" >= 1 characters
grossAmount

Full available balance before fees are deducted

number | null
""
transferFeeAmount

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

number | null
""
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
""
amount
required

Net amount sent to Revolut (grossAmount − transferFee − fxFee)

number
""
currencyCode
required

ISO 4217 currency code of the withdrawal

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

Current status of the withdrawal lifecycle

string
""
Allowed values: PENDING PROCESSING COMPLETED FAILED
revolutPaymentId

Revolut transaction ID returned by the Revolut Business API

string | null
""
referenceCode
required

Human-readable reference shown on bank statements

string
"" >= 1 characters
requestedAt
required

When the withdrawal was requested

string format: date-time
""
completedAt

When the withdrawal was completed (null until COMPLETED state)

string | null format: date-time
""
Example 
[
  {
    "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
    "accountIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
    "bankAccountIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
    "grossAmount": "5250.50",
    "transferFeeAmount": "5.00",
    "fxFeeRate": "0.006",
    "fxFeeAmount": "31.50",
    "amount": "5214.00",
    "currencyCode": "USD",
    "status": "COMPLETED",
    "revolutPaymentId": "1234567890abcdef",
    "referenceCode": "PAYP2026021401",
    "requestedAt": "2026-02-14T10:30:00",
    "completedAt": "2026-02-15T14:45:30"
  }
]

400

Section titled “400 ”

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

401

Section titled “401 ”

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

403

Section titled “403 ”

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

404

Section titled “404 ”

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

405

Section titled “405 ”

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

415

Section titled “415 ”

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

500

Section titled “500 ”

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

503

Section titled “503 ”

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