Skip to content
Wink

Show booking

GET
/api/managing-entity/{managingEntityIdentifier}/channel-manager/booking/{bookingIdentifier}
 
curl --request GET \
  --url https://integrations.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/channel-manager/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.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Property identifier (UUID)

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

Booking identifier (UUID)

Example 
f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
bookingIdentifier
required

Booking ID

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

Property ID

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

Master Rate ID

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

Master Rate name

string
"" >= 1 characters
guestRoomName
required

Guest room name

string
"" >= 1 characters
ratePlanName
required

Rate plan name

string
"" >= 1 characters
rooms
required

Number of rooms in booking

integer format: int32
""
guests
required

Total number of guests (adults and children)

integer format: int32
""
adults
required

Number of adults in booking

integer format: int32
""
children
required

Number of children in booking

integer format: int32
""
firstName
required

First name of primary guest

string
"" >= 1 characters
lastName
required

Last name of primary guest

string
"" >= 1 characters
email
required

Email address of primary guest

string
"" >= 1 characters
amount
required

Total booking amount in supplier currency

number
""
currencyCode
required

Supplier currency code

string
"" >= 1 characters
bookingCode
required

User-friendly booking confirmation code

string
"" >= 1 characters
startDate
required

Room check-in date (arrival)

string format: date
""
endDate
required

Room check-out date (departure)

string format: date
""
createdDate
required

Timestamp when booking was created

string format: date-time
""
cancelled
required

Whether the booking is cancelled

boolean
cancelDate

Timestamp when booking was cancelled (null if not cancelled)

string format: date-time
""
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
""
paymentMethodStatus
required

Payment transaction status

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

Sales channel name (bookable inventory source)

string
"" >= 1 characters
salesChannelIdentifier
required

Sales channel ID

string format: uuid
"" >= 1 characters
Example 
{
  "bookingIdentifier": "",
  "propertyIdentifier": "",
  "roomRateIdentifier": "",
  "name": "",
  "guestRoomName": "",
  "ratePlanName": "",
  "rooms": "",
  "guests": "",
  "adults": "",
  "children": "",
  "firstName": "",
  "lastName": "",
  "email": "",
  "amount": "",
  "currencyCode": "",
  "bookingCode": "",
  "startDate": "",
  "endDate": "",
  "createdDate": "",
  "cancelled": false,
  "cancelDate": "",
  "paymentMethodType": "",
  "paymentWalletType": "",
  "paymentMethodStatus": "INITIALIZED",
  "salesChannelName": "",
  "salesChannelIdentifier": ""
}

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}