Quote group cancellation
const url = 'https://api.wink.travel/api/booking/group/a1f4c9e2-7b3d-4e8a-9c21-6f0b5d8e3a47/refund-preview?hotelIdentifier=e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18';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/booking/group/a1f4c9e2-7b3d-4e8a-9c21-6f0b5d8e3a47/refund-preview?hotelIdentifier=e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18' \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Read-only preview of the refund for cancelling a group booking, optionally scoped to one hotel, reporting per-booking refundability and the aggregate. Nothing is cancelled.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Quote cancellation for this group identifier
Example
a1f4c9e2-7b3d-4e8a-9c21-6f0b5d8e3a47Query Parameters
Section titled “Query Parameters”Optional. Restrict the quote to bookings for this property within the group.
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Group cancellation refund preview
Read-only preview of what cancelling a booking group would refund, shown to the traveler before they confirm cancellation.
object
The traveler’s display currency code.
The group code being quoted.
Property the quote is scoped to, or null for the whole trip.
One entry per booking that would be cancelled.
A single booking’s line in a group refund preview, showing the refund amount and cancellation details for that booking.
object
The human-readable booking code.
The booking’s internal identifier.
Human-readable cancellation policy text (may be long).
Check-out date.
The property name for this booking.
Refund amount in the traveler’s display currency (0 when non-refundable).
Whether the refund is FULL, PARTIAL, or NONE.
Whether this booking refunds any money when cancelled.
Check-in date.
Aggregate refund across all lines, in display currency.
Example
{ "displayCurrency": "USD", "groupIdentifier": "G-UOCWALXX", "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "lines": [ { "bookingCode": "MAVWBWMD", "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92", "cancellationPolicy": "Full refund if cancelled before 48 hours of check-in.", "endDate": "2026-06-10", "hotelName": "The Siam Residences, Bangkok", "refundDisplayAmount": 120, "refundType": "FULL", "refundable": true, "startDate": "2026-06-09" } ], "totalRefundDisplayAmount": 240}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