Ledger transaction history
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/ledger/transactions?page=0&size=20';const options = { method: 'GET', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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”Managing entity identifier (UUID)
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Query Parameters
Section titled “Query Parameters”Zero-based page number for pagination
Example
0Number of results per page
Example
20Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Transaction history retrieved successfully; ordered newest first. Supports pagination via page and size parameters.
Lightweight projection of a double-entry ledger record tracking all incoming and outgoing funds for a beneficiary account (hotels, affiliates, etc.).
object
Unique identifier for this record.
Datetime this record was first created
Datetime this record was last updated
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.
Identifier of the account being credited or debited (e.g., hotel code or affiliate ID)
Display name of the account
Human-readable description of the transaction (e.g., ‘Sale revenue for booking WNK4ZQ7P’)
Reference identifier linking this ledger entry to its source transaction (e.g., booking ID, withdrawal ID, deposit ID)
Type of entity referenced by referenceIdentifier (BOOKING_CONTRACT, WITHDRAWAL, DEPOSIT, TRANSFER)
Economic category of the funds (e.g., SALE for hotel revenue, COMMISSION for affiliate earnings, TRANSACTION_FEE for payment processing costs)
Ledger entry direction: CREDIT (incoming funds) or DEBIT (outgoing funds)
Accounting classification per the five-account model (ASSETS, LIABILITIES, EQUITY, INCOME, EXPENSES)
Usage category for the account type (CASH, RECEIVABLE, PAYABLE, INVENTORY, CAPITAL)
Monetary amount of the transaction. Debits are negative values; credits are positive.
object
Monetary amount value
ISO 4217 currency code
Optional metadata map for domain-specific transaction context (e.g., bank fees, FX rates, reconciliation details)
object
Example
[ { "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "createdDate": "2026-01-14T09:30:00", "lastUpdate": "2026-01-14T09:30:00", "accountIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "accountName": "The Siam Residences, Bangkok", "description": "Sale: The Siam Residences, Bangkok", "referenceIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "referenceType": "BOOKING_CONTRACT", "fundsType": "SALE", "type": "DEBIT", "accountType": "INCOME", "accountUsageType": "RECEIVABLE", "entry": { "amount": 450, "currency": "THB" }, "metadata": {} }]Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable