Skip to content
Wink

Ledger transaction history

GET
/api/managing-entity/{managingEntityIdentifier}/payment/ledger/transactions
 
curl --request GET \
  --url 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/ledger/transactions?page=0&size=20' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns a page of ledger entries for the given managing entity, ordered newest first. Entries include debits (payouts), credits (commissions/adjustments), and the associated metadata. Supports pagination via page and size parameters (defaults 0 and 20).

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 ”
page
string
""

Zero-based page number for pagination

Example 
0
size
string
""

Number of results per page

Example 
20

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 ”

Transaction history retrieved successfully

Media type application/json
Array<object>

Double-entry ledger record tracking all incoming and outgoing funds for a beneficiary account (hotels, affiliates, etc.). Each transaction is recorded as a credit/debit pair to maintain balanced accounting.

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

Identifier of the account being credited or debited (e.g., hotel code or affiliate ID)

string
"" >= 1 characters
accountName
required

Display name of the account

string
"" >= 1 characters
description
required

Human-readable description of the transaction (e.g., ‘Sale revenue for booking WNK4ZQ7P’)

string
"" >= 1 characters
referenceIdentifier
required

Reference identifier linking this ledger entry to its source transaction (e.g., booking ID, withdrawal ID, deposit ID)

string
"" >= 1 characters
referenceType
required

Type of entity referenced by referenceIdentifier (BOOKING_CONTRACT, WITHDRAWAL, DEPOSIT, TRANSFER)

string
""
Allowed values: BOOKING_CONTRACT DEPOSIT WITHDRAWAL TRANSFER
fundsType
required

Economic category of the funds (e.g., SALE for hotel revenue, COMMISSION for affiliate earnings, TRANSACTION_FEE for payment processing costs)

string
""
Allowed values: COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE TRANSACTION_FEE FX_FEE PLATFORM_FEE SALE TRIP_PAY STRIPE_REFUND_FEE
type
required

Ledger entry direction: CREDIT (incoming funds) or DEBIT (outgoing funds)

string
""
Allowed values: CREDIT DEBIT
accountType
required

Accounting classification per the five-account model (ASSETS, LIABILITIES, EQUITY, INCOME, EXPENSES)

string
""
Allowed values: ASSETS LIABILITIES EQUITY INCOME EXPENSES
accountUsageType
required

Usage category for the account type (CASH, RECEIVABLE, PAYABLE, INVENTORY, CAPITAL)

string
""
Allowed values: CASH RECEIVABLE PAYABLE INVENTORY CAPITAL
entry
required

Monetary amount of the transaction. Debits are negative values; credits are positive.

object
amount
required
number
currency
required
string
>= 1 characters
metadata

Optional metadata map for domain-specific transaction context (e.g., bank fees, FX rates, reconciliation details)

object
key
additional properties
Example 
[
  null
]

400

Section titled “400 ”

Invalid pagination parameters

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 not found

Media type application/json
Array<object>

Double-entry ledger record tracking all incoming and outgoing funds for a beneficiary account (hotels, affiliates, etc.). Each transaction is recorded as a credit/debit pair to maintain balanced accounting.

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

Identifier of the account being credited or debited (e.g., hotel code or affiliate ID)

string
"" >= 1 characters
accountName
required

Display name of the account

string
"" >= 1 characters
description
required

Human-readable description of the transaction (e.g., ‘Sale revenue for booking WNK4ZQ7P’)

string
"" >= 1 characters
referenceIdentifier
required

Reference identifier linking this ledger entry to its source transaction (e.g., booking ID, withdrawal ID, deposit ID)

string
"" >= 1 characters
referenceType
required

Type of entity referenced by referenceIdentifier (BOOKING_CONTRACT, WITHDRAWAL, DEPOSIT, TRANSFER)

string
""
Allowed values: BOOKING_CONTRACT DEPOSIT WITHDRAWAL TRANSFER
fundsType
required

Economic category of the funds (e.g., SALE for hotel revenue, COMMISSION for affiliate earnings, TRANSACTION_FEE for payment processing costs)

string
""
Allowed values: COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE TRANSACTION_FEE FX_FEE PLATFORM_FEE SALE TRIP_PAY STRIPE_REFUND_FEE
type
required

Ledger entry direction: CREDIT (incoming funds) or DEBIT (outgoing funds)

string
""
Allowed values: CREDIT DEBIT
accountType
required

Accounting classification per the five-account model (ASSETS, LIABILITIES, EQUITY, INCOME, EXPENSES)

string
""
Allowed values: ASSETS LIABILITIES EQUITY INCOME EXPENSES
accountUsageType
required

Usage category for the account type (CASH, RECEIVABLE, PAYABLE, INVENTORY, CAPITAL)

string
""
Allowed values: CASH RECEIVABLE PAYABLE INVENTORY CAPITAL
entry
required

Monetary amount of the transaction. Debits are negative values; credits are positive.

object
amount
required
number
currency
required
string
>= 1 characters
metadata

Optional metadata map for domain-specific transaction context (e.g., bank fees, FX rates, reconciliation details)

object
key
additional properties
Example 
[
  null
]

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}