List bookings
const url = 'https://integrations.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/channel-manager/property/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/booking/list?startDate=2026-02-01T10%3A30%3A00&endDate=2026-02-02T10%3A30%3A00';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://integrations.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/channel-manager/property/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/booking/list?startDate=2026-02-01T10%3A30%3A00&endDate=2026-02-02T10%3A30%3A00' \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Returns all bookings created for the given property between startDate and endDate; when endDate is omitted it defaults to startDate plus one day.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Rate provider (channel-manager account) identifier (UUID)
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Property identifier (UUID)
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Query Parameters
Section titled “Query Parameters”Start timestamp for booking creation date filter (inclusive); if endDate is omitted, it defaults to startDate + 1 day
Example
2026-02-01T10:30:00End timestamp for booking creation date filter (inclusive; optional; defaults to startDate + 1 day)
Example
2026-02-02T10:30:00Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”All bookings for the given property in the requested creation date range
A single booking for a property: guest details, payment status, the net sales total, and one room-stay entry per booked room
object
User-friendly booking confirmation code
Booking ID
Timestamp when booking was cancelled (null if not cancelled)
Whether the booking is cancelled
Timestamp when booking was created
Supplier currency code
Email address of primary guest
First name of primary guest
Last name of primary guest
Booking LIFECYCLE status — this does not report refunds; read refundState for that. INITIALIZED: awaiting payment; TEST_PAYMENT_SUCCEEDED: test booking; PAYMENT_SUCCEEDED: payment confirmed; PAYMENT_FAILED: payment declined; FAILED: system failure post-payment; CANCELLED: cancelled by any party. PARTIALLY_REFUNDED and FULLY_REFUNDED are retained only for bookings written before the lifecycle and refund axes were separated and are never emitted for anything refunded after that; a refunded booking that was not cancelled reports PAYMENT_SUCCEEDED here.
Payment method type (e.g. Card, Direct Debit)
Payment wallet provider if applicable (e.g. Google Pay, Apple Pay)
Property ID
How much of the booking has been refunded, independent of the lifecycle status. NONE: nothing settled; PARTIAL: some of the amount returned; FULL: the whole amount returned. Absent on responses built before this field existed — treat absent as NONE.
Per-room stay detail — one entry per physical room booked
A single physical room within a booking, including its rate, occupancy, stay dates, and per-room net sales amount
object
Number of adults in this room
Net sales amount for this room in supplier currency (the booking’s net sales total divided across its rooms)
Number of children in this room
Room check-out date (departure)
Guest room name
Total number of guests in this room (adults and children)
Master Rate name
Total number of room types requested
Rate plan name
Master Rate ID
Room check-in date (arrival)
Sales channel ID
Sales channel name (bookable inventory source)
Net sales total in supplier currency — the amount the hotel receives for the entire booking (all rooms)
Example
[ { "bookingCode": "WNK4ZQ7P", "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92", "cancelled": false, "createdDate": "2026-02-01T10:30:00", "currencyCode": "THB", "firstName": "Alexandra", "lastName": "Beaumont", "paymentMethodStatus": "PAYMENT_SUCCEEDED", "paymentMethodType": "Card", "propertyIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "roomStays": [ { "adults": 2, "amount": "450.00", "children": 1, "endDate": "2026-02-17", "guestRoomName": "Superior Deluxe", "guests": 3, "name": "Superior Deluxe - BAR", "ratePlanName": "BAR", "roomRateIdentifier": "5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73", "startDate": "2026-02-15" } ], "salesChannelIdentifier": "7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52", "salesChannelName": "Wink Travel Agents", "totalAmount": "450.00" }]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