Skip to content

Show booking

GET
/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/{bookingIdentifier}
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/f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92 \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Returns the single booking identified by the given booking ID for the given property.

managingEntityIdentifier
required
string
""

Rate provider (channel-manager account) identifier (UUID)

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
propertyIdentifier
required
string
""

Property identifier (UUID)

Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
bookingIdentifier
required
string
""

Booking identifier (UUID)

Example
f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

The requested booking

Media typeapplication/json

A single booking for a property: guest details, payment status, the net sales total, and one room-stay entry per booked room

object
bookingCode
required

User-friendly booking confirmation code

string
"" >= 1 characters
bookingIdentifier
required

Booking ID

string format: uuid
"" >= 1 characters
cancelDate

Timestamp when booking was cancelled (null if not cancelled)

string format: date-time
""
cancelled
required

Whether the booking is cancelled

boolean
createdDate
required

Timestamp when booking was created

string format: date-time
""
currencyCode
required

Supplier currency code

string
"" >= 1 characters
email
required

Email address of primary guest

string
"" >= 1 characters
firstName
required

First name of primary guest

string
"" >= 1 characters
lastName
required

Last name of primary guest

string
"" >= 1 characters
paymentMethodStatus
required

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.

string
""
Allowed values: INITIALIZED TEST_PAYMENT_SUCCEEDED PAYMENT_SUCCEEDED PAYMENT_FAILED FAILED CANCELLED PARTIALLY_REFUNDED FULLY_REFUNDED
paymentMethodType
required

Payment method type (e.g. Card, Direct Debit)

string
"" >= 1 characters
paymentWalletType

Payment wallet provider if applicable (e.g. Google Pay, Apple Pay)

string
""
propertyIdentifier
required

Property ID

string format: uuid
"" >= 1 characters
refundState

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.

string
""
Allowed values: NONE PARTIAL FULL
roomStays
required

Per-room stay detail — one entry per physical room booked

Array<object>
"" >= 1 items

A single physical room within a booking, including its rate, occupancy, stay dates, and per-room net sales amount

object
adults
required

Number of adults in this room

integer format: int32
""
amount
required

Net sales amount for this room in supplier currency (the booking’s net sales total divided across its rooms)

number
""
children
required

Number of children in this room

integer format: int32
""
endDate
required

Room check-out date (departure)

string format: date
""
guestRoomName
required

Guest room name

string
"" >= 1 characters
guests
required

Total number of guests in this room (adults and children)

integer format: int32
""
name
required

Master Rate name

string
"" >= 1 characters
quantity
required

Total number of room types requested

integer format: int32
""
ratePlanName
required

Rate plan name

string
"" >= 1 characters
roomRateIdentifier
required

Master Rate ID

string format: uuid
"" >= 1 characters
startDate
required

Room check-in date (arrival)

string format: date
""
salesChannelIdentifier
required

Sales channel ID

string format: uuid
"" >= 1 characters
salesChannelName
required

Sales channel name (bookable inventory source)

string
"" >= 1 characters
totalAmount
required

Net sales total in supplier currency — the amount the hotel receives for the entire booking (all rooms)

number
""
key
additional properties
""
Example
{
"bookingCode": "WNK4ZQ7P",
"bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92",
"cancelled": false,
"createdDate": "2026-02-01T10:30:00",
"currencyCode": "THB",
"email": "[email protected]",
"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

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example