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
Identifier of the account being credited or debited (e.g., hotel code or affiliate ID)
Display name of the account
Accounting classification per the five-account model (ASSETS, LIABILITIES, EQUITY, INCOME, EXPENSES)
Usage category for the account type (CASH, RECEIVABLE, PAYABLE, INVENTORY, CAPITAL)
Datetime this record was first created
Human-readable description of the transaction (e.g., ‘Sale revenue for booking WNK4ZQ7P’)
Monetary amount of the transaction. Debits are negative values; credits are positive.
object
Monetary amount value
ISO 4217 currency code
Economic category of the funds (e.g., SALE for hotel revenue, COMMISSION for affiliate earnings, TRANSACTION_FEE for payment processing costs)
Unique identifier for this record.
Datetime this record was last updated
Optional metadata map for domain-specific transaction context (e.g., bank fees, FX rates, reconciliation details)
object
Identifier shared by every entry written by the same posting, i.e. the two legs of one double-entry pair. Null on rows written before this field existed; the posting-group endpoint falls back to a documented heuristic for those.
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)
Ledger entry direction: CREDIT (incoming funds) or DEBIT (outgoing funds)
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.
Example
[ { "accountIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "accountName": "The Siam Residences, Bangkok", "accountType": "INCOME", "accountUsageType": "RECEIVABLE", "createdDate": "2026-01-14T09:30:00", "description": "Sale: The Siam Residences, Bangkok", "entry": { "amount": 450, "currency": "THB" }, "fundsType": "SALE", "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "lastUpdate": "2026-01-14T09:30:00", "metadata": {}, "postingGroupId": "7f1c9e4b-2a6d-4f83-b5e1-0c9a7d3e5f21", "referenceIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "referenceType": "BOOKING_CONTRACT", "type": "DEBIT" }]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