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 typeapplication/json
Array<object>

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

object
accountIdentifier

TripPay account identifier of the beneficiary requesting withdrawal

string format: uuid
amount

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

number
bankAccountIdentifier

BankAccount identifier within the account

string format: uuid
completedAt

When the withdrawal was completed (null until COMPLETED state)

string format: date-time
createdDate

Datetime this record was first created

string | null format: date-time
currencyCode

ISO 4217 currency code of the withdrawal

string
/^[A-Z]{3}$/
fxFeeAmount

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

number
fxFeeRate

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

number
grossAmount

Full available balance before fees are deducted

number
id

Unique identifier for this record.

string format: uuid
lastUpdate

Datetime this record was last updated

string | null format: date-time
referenceCode

Human-readable reference shown on bank statements

string
requestedAt

When the withdrawal was requested

string format: date-time
revolutPaymentId

Revolut transaction ID returned by the Revolut Business API

string
status

Current status of the withdrawal lifecycle

string
Allowed values: PENDING PROCESSING COMPLETED FAILED
transferFeeAmount

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

number
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64
Example
[
  {
    "accountIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
    "amount": 5214,
    "bankAccountIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
    "completedAt": "2026-02-15T14:45:30",
    "createdDate": "2026-01-14T09:30:00",
    "currencyCode": "USD",
    "fxFeeAmount": 31.5,
    "fxFeeRate": 0.006,
    "grossAmount": 5250.5,
    "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
    "lastUpdate": "2026-02-03T16:45:12",
    "referenceCode": "PAYP2026021401",
    "requestedAt": "2026-02-14T10:30:00",
    "revolutPaymentId": "1234567890abcdef",
    "status": "COMPLETED",
    "transferFeeAmount": 5,
    "version": 3
  }
]

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

401

Section titled “401”

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

403

Section titled “403”

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

404

Section titled “404”

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

405

Section titled “405”

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

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

415

Section titled “415”

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

500

Section titled “500”

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}

503

Section titled “503”

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
Examplegenerated
{
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  },
  "status": 1,
  "title": "example",
  "type": "https://example.com"
}