Skip to content

Show Public Booking

GET
/booking/{bookingIdentifier}
curl --request GET \
--url https://api.wink.travel/booking/booking-1 \
--header 'Wink-Version: 2.0'

Retrieve a booking by its booking identifier and return publicly available booking data.

bookingIdentifier
required
string
""

Retrieve booking by identifier

Example
booking-1
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

OK

Media type application/json
object
id

Document UUID

string
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.

integer format: int64
""
creation
required

Whether this was a test booking by the property than can safely be deleted again

string
default: false
Allowed values: NORMAL TEST FAILED
cancelled
required

Whether this was cancelled

boolean
groupIdentifier
required

Unique record identifier for the collection of bookings that were made at the same time.

string format: uuid
""
customization
required

Which customization configuration record did the entity application used to facilitate in making this booking happen.

object
identifier
required

Unique customization configuration identifier

string format: uuid
""
name
required

Engine configuration name

string
"" >= 1 characters
userIdentifier
required

Authenticated user identifier

string format: uuid
""
ownerIdentifier
required

Engine configuration record creator identifier

string format: uuid
""
ownerName
required

Name of company owner.

string
""
subType
required

Sales channel sub-type.

string
""
Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER
defaultCurrency

Control which currency your users see prices in initially.

string
default: USD
defaultLanguage

Control which language your users see text in initially.

string
default: en
defaultLifestyle

Control which lifestyle contextx your users see initially.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
logos

Customize booking confirmation emails by adding a custom logo to your configuration.

Array<object>
""

Multimedia that contains less information than Multimedia object

object
multimediaIdentifier
required

Document identifier

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

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
hostedBookingEngineUrl

If you are self-hosting our booking customization, let us know where it is hosted. Note: This url needs to be secured with SSL.

string
default: https://ota.wink.travel
selfHosted

Flag to indicate you are self-hosting our booking customization and not using our default booking customization url.

boolean
themeColors

Choose how you want our web components to look and more closely match with your own site style.

object
primary

Primary color

string
default: #dc3545
secondary

Secondary color

string
default: #6c757d
success

Success color

string
default: #28a745
danger

Danger color

string
default: #dc3545
warning

Warning color

string
default: #ffc107
info

Info color

string
default: #17a2b8
light

Light color

string
default: #f8f9fa
dark

Dark color

string
default: #343a40
body

Body color

string
default: #212529
muted

Muted color

string
default: #6c757d
white

White color

string
default: #ffffff
cardLayout

Choose how you large you want our web component cards to be.

string
default: VERTICAL
Allowed values: HORIZONTAL VERTICAL
layout

Choose how you want our web component cards laid out.

string
default: INFORMATIONAL
Allowed values: INFORMATIONAL TRANSACTIONAL
cardDesign

Choose the card design to use on our web component cards.

string
default: DEFAULT
Allowed values: DEFAULT
numberOfAdvanceDays

You can control the initial itinerary date used to retrieve travel inventory prices. You can do it in one of two ways: 1. Dynamically set the date by indicating how long and how many days in advance (this field), of today’s date, you want to display prices for. 2. Set a fixed date to display prices for. Option 1 is the most shared. Option 2 is for when you want to create a new customization and apply it to a specific event that occurs on a specific date. If you don’t use either of these options, the itinerary will default to today’s date with one night stay. ONLY populate this field if you want to control the itinerary date. Also, leave startDate and endDate empty.

integer format: int32
""
numberOfStayDays

You can control the initial itinerary date used to retrieve travel inventory prices. You can do it in one of two ways: 1. Dynamically set the date by indicating how long (this field) and how many days in advance, of today’s date, you want to display prices for. 2. Set a fixed date to display prices for. Option 1 is the most shared. Option 2 is for when you want to create a new customization and apply it to a specific event that occurs on a specific date. If you don’t use either of these options, the itinerary will default to today’s date with one night stay. ONLY populate this field if you want to control the itinerary date. Also, leave startDate and endDate empty.

integer format: int32
""
startDate

Set a fixed itinerary start date. ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.

string format: date
""
endDate

Set a fixed itinerary end date ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.

string format: date
""
roomConfigurations

Control how many adults / children will be staying and how many rooms. Defaults to: One room, two adults.

Array<object>
""

Room Configuration

object
adults
required

Number of adults

integer format: int32
default: 1 >= 1
children

Children configurations

Array<object>

BookingItineraryRoomConfigurationChild configuration

object
quantity
required

Number of children

integer format: int32
"" >= 1
age
required

Age of children

integer format: int32
""
quantity

Number of identical rooms of this configuration being booked

integer format: int32
default: 1 >= 1
useDays

If true, we use numberOfAdvanceDays / numberOfStayDays properties - false, we use startDate / endDate

boolean
promotionalCodes

If you’ve received special promotional codes from suppliers to give to your audience, you can choose to bake these code directly into the price by entering them here.

Array<string>
""
sendBookingNotificationEmailsToProperty

An integrator can choose to disable outgoing emails to properties because they want to do that themselves.

boolean
default: true
sendBookingNotificationEmailsToBooker

An integrator can choose to disable outgoing emails to users because they want to do that themselves.

boolean
default: true
sendBookingNotificationEmailsToChannelManager

An integrator can choose to disable notifying the property’s channel manager. Note: This should ONLY be done for testing.

boolean
default: true
wcBookClickAction

Action to complete once a user clicks on the CTA button on inventory.

string
""
Allowed values: FORWARD_TO_IBE IBE_MODAL
city

GeoNames have been created at https://geonames.org and contain geographical destinations we use as geoname data to associate travel inventory with a location.

object
geoNameId

GeoName identifier

string
""
type

GeoNameLightweight type

string
""
Allowed values: CITY ISLAND OTHER
name

Name of city

string
""
urlName

Url name

string
""
asciiName

Ascii name of city

string
""
location

Coordinate points of the city

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
featureCode
string
countryCode
string
timezone

Timezone

string
""
country

Country

object
iso

ISO code

string
""
name

Country name

string
""
capital

Country capital

string
""
continent

Continent code

string
""
currencyCode

Currency code

string
""
currencyName

Currency name

string
""
geoNameId

Country GeoNames identifier

string
""
subCountry

Country sub division

object
name

Sub-country name

string
""
asciiName

Sub-country ascii name

string
""
geoNameId

Sub-country GeoNames identifier

string
""
subSubCountry

Country sub sub division

object
name
string
asciiName
string
geoNameId
string
showUnavailableCard

Show unavailable inventory card when inventory not currently for sale. Otherwise, it displays a normal card but without the price.

boolean
showRankings

Whether to display rankings (lifestyle, eco score and reviews) on hotel landing page.

boolean
showSearch

This feature flag controls whether to let a user move away from the hotel landing page using search.

boolean
trackingPixels

Tracking pixels and web beacons for analytics and conversion tracking.

Array<object>
""
object
identifier
required

Unique identifier for this tracking pixel

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

User-friendly name for this tracking pixel

string
"" >= 1 characters
type
required

Type of tracking pixel delivery mechanism

string
""
Allowed values: JAVASCRIPT IMAGE
provider
required

Tracking pixel provider

string
""
Allowed values: FACEBOOK GOOGLE_ADS GOOGLE_ANALYTICS TIKTOK LINKEDIN PINTEREST SNAPCHAT TWITTER SOJOURN CUSTOM
consentCategory
required

Consent category for GDPR/CCPA compliance

string
""
Allowed values: STRICTLY_NECESSARY FUNCTIONAL ANALYTICS MARKETING
enabled

Whether this tracking pixel is currently active

boolean
default: true
pixelId

Provider-specific pixel ID (e.g., Facebook Pixel ID, Google Ads Conversion ID)

string
""
accessToken

Optional access token for providers that require authentication

string
""
customScript

Custom JavaScript code for CUSTOM provider type. Will be injected into the page.

string
""
customImageUrl

Custom image URL for IMAGE type pixels. Will be loaded as a 1x1 tracking pixel.

string
""
pageTypes

Page types where this pixel should fire. Empty list or containing ALL means fire on all pages.

Array<string>
""
Allowed values: ALL LANDING_PAGE SEARCH_RESULTS ROOM_SELECTION CHECKOUT CONFIRMATION
triggers

Event triggers that cause this pixel to fire, with optional custom parameters.

Array<object>
""
object
eventType
required

The event type that triggers this pixel

string
""
Allowed values: PAGE_VIEW SEARCH VIEW_CONTENT ADD_TO_CART INITIATE_CHECKOUT ADD_PAYMENT_INFO PURCHASE LEAD SIGN_UP
parameters

Custom key-value parameters to include with the event

Array<object>
""
object
key
required

Parameter name (e.g., ‘currency’, ‘value’, ‘content_id’)

string
"" >= 1 characters
value
required

Parameter value. Can be a static value or a placeholder like ‘{booking.total}’

string
"" >= 1 characters
fontId

Custom font for the booking engine. Null means use the system default.

string
""
Allowed values: UI_SANS_SERIF UI_SERIF PLAYFAIR_DISPLAY LIBRE_BASKERVILLE CORMORANT_GARAMOND JOSEFIN_SANS RALEWAY LORA SPACE_GROTESK DM_SERIF_DISPLAY OUTFIT CRIMSON_PRO CINZEL BODONI_MODA EB_GARAMOND ITALIANA FORUM TENOR_SANS GILDA_DISPLAY MARCELLUS
bookingCode
required

Unique user-friendly booking geoname. This code should be used when corresponding with travelers.

string
""
user
required

User details for the authenticated person that made the booking.

object
firstName
required

First name

string
"" >= 1 characters
lastName
required

Last name

string
"" >= 1 characters
fullName

Full name

string
""
userSession
required

User session state as it was when the user made the booking.

object
itinerary
required

Dates and travel info.

object
startDate
required

Start date of itinerary

string format: date
""
endDate

Optional end date. If endDate is empty, nights needs to be present. If both are present, nights will take precedence.

string format: date
""
nights

Optional number of nights. If nights is empty, endDate needs to be present. If both are present, nights will take precedence.

integer format: int32
""
items

Room configurations

Array<object>

Room Configuration

object
adults
required

Number of adults

integer format: int32
default: 1
children

Children configurations

Array<object>

Child configuration

object
quantity
required

Number of children

integer format: int32
""
age
required

Age of children

integer format: int32
""
hours

Number of hours between start and end dates. Used for itineraries that require bookings that occur within hours and not days. E.g. Meeting room reservation.

integer format: int64
""
children

How many total children for this stay

integer format: int32
""
rooms

How many total rooms for this stay

integer format: int32
""
guests

How many total guests for this stay

integer format: int32
""
language

User’s language preference

string
""
currency

User’s currency preference

string
""
promotionalCodes
Array<string>
selectedRoomConfigurationIndex

User can pass the current room configuration index to retrieve rates specifically for that room configuration.

integer format: int32
""
lifestyle

The preferred user lifestyle.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
serverUrl
required

The URL the booking occurred

string
""
socials

List of all social network account property has for the traveler to get in touch.

Array<object>
""

Social network

object
type

Type of social network.

string
""
Allowed values: FACEBOOK INSTAGRAM SKYPE TRIP_ADVISOR TWITTER GOOGLE_PLUS WHATSAPP LINE WECHAT VIBER SNAPCHAT WEIBO RENREN WEBSITE QQ TIKTOK
location

URL or social network identifier to social network profile

string
""
review

User review created by the traveler after the booking completed.

object
identifier

Unique review identifier identifying this record.

string format: uuid
""
bookingIdentifier

Booking identifier identifier booking this review is associated with.

string format: uuid
""
hotelIdentifier

Hotel identifier this booking is associated with.

string format: uuid
""
user

User details of creator of booking.

object
userIdentifier

User identifier

string format: uuid
""
firstName

First name

string
""
lastName

Last name

string
""
email

Email

string format: email
""
telephone

Telephone

string
""
fullName

Full name

string
""
reviewDate

Date of review.

string format: date-time
""
averageScore

Total points divided by number of questions.

number format: double
""
answers

List of user review answers.

Array<object>
object
questionIdentifier
required

Question identifier

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

Question category

string
""
Allowed values: COMFORT CONDITION SERVICE ENVIRONMENT FACILITIES LOCATION LIFESTYLE VALUE FOOD ROOM
sort
required

Sort key

integer format: int32
""
value
required

Value

integer format: int32
""
messageFromGuest

Private message from guest to the hotel. Is not displayed on property profile.

string
""
responseFromHotel

Property can response to traveler review. Response goes on public review profile and can be seen by others.

string
""
imageIdentifier

Reviewer can upload her best picture from the property. Cloudinary image identifier.

string
""
text

Free text record created by traveler

string
""
approvedText

Hotel allows the review text to be displayed as part of their profile.

boolean
approvedImage

Hotel allows the user-generated image to be displayed as part of their profile.

boolean
likes

List of member identifiers who liked the textual review

Array<string>
roomNumber

Guest’s room number during their stay.

string
""
roomRating

Guest’s room rating

integer format: int32
""
responded

Returns true if property has responded to the review given by the guest.

boolean
emailHeaderLogoUrl
required

Full url of the image logo optimized for emails

string
""
logoIdentifier

Logo cloudinary identifier for potential reuse

string
""
hotel
required

Combined property data.

object
hotelIdentifier

Unique hotel record identifier.

string format: uuid
""
name

Hotel trade name

string
""
localName

Hotel local name if different from the trade name or if it is the local language.

string
""
chain

Name of hotel chain if applicable.

string
""
brand

Name of hotel brand

string
""
urlName

Unique URL-friendly name slug of hotel

string
""
uniqueId
required

Event shorter name

string
"" >= 1 characters
starRating

Official or self-designated property star rating. Note that in some regions there are 6-star hotels. They are the same as 5-star hotels everywhere else.

integer format: int32
"" <= 6
bookings

Number of bookings for this property on the wink.travel platform.

integer format: int64
0
aggregateReviewRating

Aggregate score based on all current user reviews.

number format: float
default: 0.0
location

Geo-location

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
descriptions

Short and long welcome text

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
aggregateGreendexRating

Aggregate Green Index score if the property has answered our questionnaire available in the Extranet.

number format: float
default: 0.0
lifestyleTypes
Array<string>
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
totalReviews

Count of total reviews left by users at this property.

integer format: int32
0
reservations

Contact details for reservations desk

object
firstName

Contact first name

string
""
lastName

Contact last name

string
""
email

Contact E-mail

string format: email
""
secondaryEmail

Contact secondary Email

string
""
phoneNumber

Contact phone number

string
""
fullName

First and last name

string
""
summary

Summary

string
""
socials

Property’s social network accounts

Array<object>
""

Social network

object
type

Type of social network.

string
""
Allowed values: FACEBOOK INSTAGRAM SKYPE TRIP_ADVISOR TWITTER GOOGLE_PLUS WHATSAPP LINE WECHAT VIBER SNAPCHAT WEIBO RENREN WEBSITE QQ TIKTOK
location

URL or social network identifier to social network profile

string
""
images

Property images.

Array<object>
""

Multimedia that contains less information than Multimedia object

object
multimediaIdentifier
required

Document identifier

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

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
videos

Property videos.

Array<object>
""

Multimedia that contains less information than Multimedia object

object
multimediaIdentifier
required

Document identifier

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

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
policy

Basic property policy record.

object
childrenAllowed
required

Indicates whether property allows children

boolean
childrenMinimumAge

When a property allows children, it can also indicate what the minimum age is for children to be allowed.

integer format: int32
""
internetAvailability
required

Indicates the availability of internet on the property.

string
""
Allowed values: YES NO YES_PAID
internetConnectionType

Indicates how guests can access the Internet on the property.

string
""
Allowed values: WIFI CABLE
internetConnectionLocation

Indicates where internet is available in and around the property.

string
""
Allowed values: ENTIRE_PROPERTY PUBLIC_AREAS ALL_ROOMS SOME_ROOMS BUSINESS_CENTER
parkingAvailability
required

Indicates whether parking is available at the property.

string
""
Allowed values: YES NO YES_PAID
parkingAccess

Indicates what type of parking is available at the property.

string
""
Allowed values: PRIVATE PUBLIC
petsAllowed
required

Indicates whether pets are allowed on the property. Note: There are thousand different kinds of pets. Just because the property allows small dogs does not mean the guest can bring a python. Always best to check with property.

boolean
petMaxWeightInKilos

If pets are allowed, property can further limit on weight.

integer format: int32
""
petCharge

If pets are allowed, property can tell travelers if there is a charge applicable for the pet.

object
amount
required
number
currency
required
string
>= 1 characters
checkOutTime
required

When the guest has to check out.

string
"" >= 1 characters
checkInTime
required

When the guest can check in.

string
"" >= 1 characters
thirdPartyReviews

Array of awards and third party reviews given to property by certified / non-certified providers.

Array<object>
""

Recognition for the ancillary blocking.

object
identifier
required

Recognition identifier.

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

Recognition category.

string
""
Allowed values: THIRD_PARTY_REVIEW PUBLICATION AWARD
type
required

Type of rating system the recognition operated on. This allows us to display the score properly.

string
""
Allowed values: STAR_RATING NUMERIC_RATING PERCENT_RATING
provider
required

The name of the entity that administers this recognition.

string
"" >= 1 characters
rating
required

The actual award or rating received by the hotel facility.

number format: float
""
maxRating
required

Use this to let hotels indicate what the total score for this award is.

number format: float
""
date

The date the award was received

string format: date
""
officialAppointmentInd

When true, this indicates the property has received official permission from the award provider to use the rating in publications and marketing materials; when false this permission has not been granted.

boolean
ratingSymbol

Provides the symbol used in the rating. Used in conjunction with the Rating.

string
""
attractions

Number of attractions property has listed on its profile.

integer format: int32
0
activities

Number of activites property has listed on its profile.

integer format: int32
0
places

Number of places property has listed on its profile.

integer format: int32
0
restaurants

Number of restaurants property has on its profile.

integer format: int32
0
meetingRooms

Number of meeting rooms property has on its profile.

integer format: int32
0
spas

Number of spas property has on its profile.

integer format: int32
0
addOns

Number of add-ons property has on its profile.

integer format: int32
0
generalManager

General manager related data.

object
name
required

Name of GM currently managing the property.

string
""
image

Cloudinary image identifier of GM currently managing the property.

object
multimediaIdentifier
required

Document identifier

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

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
descriptions

Localized welcome message from GM.

Array<object>
object
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
locationCategory

Supported OTA specification LOC code. See OTA geoname data

string
""
segmentCategory

Supported OTA specification SEG code. See OTA geoname data

string
""
hotelCategory

Supported OTA specification PCT code. See OTA geoname data

string
""
architecturalStyle

Supported OTA specification ARC code. See OTA geoname data

string
""
whenBuilt

Year the property was constructed.

string
""
currencyCode

Currency code for property.

string
""
membershipRateDiscount

A property’s price score is based on calculating historical pricing data. Each property receives a unique score. There is no max score; it’s there to compare it against other properties.

number format: float
0
priceScore

A property’s price score is based on calculating historical pricing data. Each property receives a unique score. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
perkScore

A property’s perk score is based on the type of perks that is offered to the guests across all master rates. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
addOnScore

A property’s package score is based on general availability and price for all packages and add-ons offered by the property. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
loyaltyScore

A property’s loyalty score is based on calculating how many available rate plans honor loyalty points. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
popularScore

A property’s popular score is based on calculating number of bookings across room types. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
experienceScore

A property’s experience score is based on how calculating how many types of experiences are available and at what price ranges. There is no max score; it’s there to compare it against other properties.

integer format: int32
0
hotelAmenityCodes

Supported OTA specification HAC code. See OTA geoname data

Array<string>
""
propertyAccessibilityCodes

Supported OTA specification PHY code. See OTA geoname data

Array<string>
""
propertySecurityCodes

Supported OTA specification SEC code. See OTA geoname data

Array<string>
""
numberOfRooms

Number of rooms / keys for this property.

integer format: int32
0
address

Property address.

object
address1

Address line 1

string
""
address2

Address line 2

string
""
state

State

string
""
postalCode

Postal / zip code

string
""
county

County

string
""
city

City name

string
""
countryCode

Country

string
""
country

Country

string
""
fullAddress

Address 1, Address 2, City, State, Postal / Zip code, Country

string
""
active

Whether property is active

boolean
roomStay
required

All information about the room that was booked.

object
policy
required

Property policy information.

object
childrenAllowed
required

Indicates whether property allows children

boolean
childrenMinimumAge

When a property allows children, it can also indicate what the minimum age is for children to be allowed.

integer format: int32
""
internetAvailability
required

Indicates the availability of internet on the property.

string
""
Allowed values: YES NO YES_PAID
internetConnectionType

Indicates how guests can access the Internet on the property.

string
""
Allowed values: WIFI CABLE
internetConnectionLocation

Indicates where internet is available in and around the property.

string
""
Allowed values: ENTIRE_PROPERTY PUBLIC_AREAS ALL_ROOMS SOME_ROOMS BUSINESS_CENTER
parkingAvailability
required

Indicates whether parking is available at the property.

string
""
Allowed values: YES NO YES_PAID
parkingAccess

Indicates what type of parking is available at the property.

string
""
Allowed values: PRIVATE PUBLIC
petsAllowed
required

Indicates whether pets are allowed on the property. Note: There are thousand different kinds of pets. Just because the property allows small dogs does not mean the guest can bring a python. Always best to check with property.

boolean
petMaxWeightInKilos

If pets are allowed, property can further limit on weight.

integer format: int32
""
petCharge

If pets are allowed, property can tell travelers if there is a charge applicable for the pet.

object
amount
required
number
currency
required
string
>= 1 characters
checkOutTime
required

When the guest has to check out.

string
"" >= 1 characters
checkInTime
required

When the guest can check in.

string
"" >= 1 characters
room
required

Guest room details.

object
identifier
required

Unique record identifier

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

Hotel identifier.

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

Indicates whether this inventory is featured. Use this flag as a way to signify that this inventory is special.

boolean
lifestyleType

Indicate the type of lifestyle this blocking should be associated with.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
location
required

Geo-location point where blocking takes place. Defaults to location of property.

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
multimedias
required

List of images / videos of blocking.

Array<object>
>= 1 items

Multimedia that contains less information than Multimedia object

object
multimediaIdentifier
required

Document identifier

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

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
contact
required

Associate a contact person for this blocking (if applicable).

object
firstName

Contact first name

string
""
lastName

Contact last name

string
""
email

Contact E-mail

string format: email
""
secondaryEmail

Contact secondary Email

string
""
phoneNumber

Contact phone number

string
""
fullName

First and last name

string
""
summary

Summary

string
""
address
required

Defaults to property address.

object
address1

Address line 1

string
""
address2

Address line 2

string
""
state

State

string
""
postalCode

Postal / zip code

string
""
county

County

string
""
city

City name

string
""
countryCode

Country

string
""
country

Country

string
""
fullAddress

Address 1, Address 2, City, State, Postal / Zip code, Country

string
""
commissionable
required

Indicate whether sales channels receive commission for selling this blocking.

boolean
default: true
name
required

Internal name of inventory.

string
"" >= 1 characters
proximityCode
required

Supported OTA specification PRX code. See OTA geoname data

string
""
sort

Use this property to sort an blocking in a list of activities.

integer format: int32
""
minAgeAppropriateCode

Supported OTA specification AQC code. See OTA geoname data

string
""
bookable
required

Indicates if this blocking can be added to a booking or if it is read-only marketing material only.

boolean
default: true
active
required

Modify blocking availability with this flag.

boolean
default: true
disabilityFeatures

Supported OTA specification PHY code. See OTA geoname data

Array<string>
securityFeatures

Supported OTA specification SEC code. See OTA geoname data

Array<string>
socials

Social network accounts for blocking (if applicable).

Array<object>

Social network

object
type

Type of social network.

string
""
Allowed values: FACEBOOK INSTAGRAM SKYPE TRIP_ADVISOR TWITTER GOOGLE_PLUS WHATSAPP LINE WECHAT VIBER SNAPCHAT WEIBO RENREN WEBSITE QQ TIKTOK
location

URL or social network identifier to social network profile

string
""
pricePoint
required

Level of expensiveness.

string
default: THREE
Allowed values: HALF ONE ONE_HALF TWO TWO_HALF THREE THREE_HALF FOUR FOUR_HALF FIVE
recognitionList

Inventory-level recognition.

Array<object>

Recognition for the ancillary blocking.

object
identifier
required

Recognition identifier.

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

Recognition category.

string
""
Allowed values: THIRD_PARTY_REVIEW PUBLICATION AWARD
type
required

Type of rating system the recognition operated on. This allows us to display the score properly.

string
""
Allowed values: STAR_RATING NUMERIC_RATING PERCENT_RATING
provider
required

The name of the entity that administers this recognition.

string
"" >= 1 characters
rating
required

The actual award or rating received by the hotel facility.

number format: float
""
maxRating
required

Use this to let hotels indicate what the total score for this award is.

number format: float
""
date

The date the award was received

string format: date
""
officialAppointmentInd

When true, this indicates the property has received official permission from the award provider to use the rating in publications and marketing materials; when false this permission has not been granted.

boolean
ratingSymbol

Provides the symbol used in the rating. Used in conjunction with the Rating.

string
""
maxOccupancy
required

Maximum number of guest allowed in a room type.

integer format: int32
default: 2 >= 1
minOccupancy
required

Minimum number of guests allowed in a room type.

integer format: int32
default: 1 >= 1
quantity
required

Defines the number of rooms of this type

integer format: int32
"" >= 1
nonSmoking
required

Non-smoking indicator

boolean
bedroomConfigurationList
required

A room type can have more than one bed configuration.

Array<object>
>= 1 items
object
identifier
required

Unique identifier

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

Name of layout

string
"" >= 1 characters
bedroomList
required

A room type can have more than one bedroom configuration.

Array<object>
>= 1 items
object
type
required

Type of bedroom

string
""
Allowed values: MASTER QUEEN JUNIOR DORMITORY BEDROOM_1 BEDROOM_2 BEDROOM_3 BEDROOM_4 BEDROOM_5 BEDROOM_6 BEDROOM_7 BEDROOM_8 BEDROOM_9 BEDROOM_10
bedList
required

A bedroom can have more than one bed type.

Array<object>
>= 1 items
object
bedTypeCode
required

Indicates the type of bed(s) found in the room. Typical values would be Double, Twin, Queen, or King. Supported OTA specification BED code. See OTA geoname data.

string
"" >= 1 characters
quantity
required

Number of beds for this bed type.

integer format: int32
"" >= 1
size
required

Number of square meters that defines the size of this room type.

number format: float
"" >= 1
maxAdultOccupancy
required

Maximum number of adults allowed in a room type.

integer format: int32
default: 2 >= 1
maxChildOccupancy
required

Maximum number of children allowed in a room type.

integer format: int32
0
bathroomCount
required

Number of bathrooms

integer format: int32
default: 1
livingRoomCount
required

Number of living rooms

integer format: int32
default: 1
maxRollaways
required

Maximum number of rollaway beds allowed in this room type.

integer format: int32
0
roomCategory
required

Indicates the category of the room. Typical values would be Moderate, Standard, or Deluxe. Supported OTA specification SEG code. See OTA geoname data

string
"" >= 1 characters
floor

Floor an which a room is located

string
""
roomLocationCode
required

Indicates the location of the room within the hotel structure. Typical values would be “Near Exit”,“Close to elevator”, “Low Floor” or “High Floor”. Supported OTA specification RLT code. See OTA geoname data

string
"" >= 1 characters
roomViewCode
required

Indicates the view of the room. Typical values would be “Ocean view”, “Pool view” or “Garden View”. Supported OTA specification RVT code. See OTA geoname data

string
"" >= 1 characters
composite
required

Indicates that the room (suite) is a composite of smaller units.

boolean
compositeCount
required

Number of rooms of this room type that makes up a larger unit (composite) such as a two bedroom suite could be comprised of two king rooms plus other room types. A 0 means disabled.

integer format: int32
0
roomClassificationCode
required

Specifies the room classification (e.g., cabin, apartment). Supported OTA specification GRI code. See OTA geoname data

string
"" >= 1 characters
roomArchitectureCode
required

Specifies the architectural style of a room. Supported OTA specification ARC code. See OTA geoname data

string
"" >= 1 characters
roomGender

Used to request or specify a gender assignment for a room. Note: Typically used by Hosteliers.

string
default: Unknown
Allowed values: Male Female MaleAndFemale Unknown
sharedRoomInd
required

If TRUE, the room requires or has sharing available. Note: Typically used by Hosteliers.

boolean
maxCribs
required

Maximum number of cribs allowed in a room type.

integer format: int32
0
amenities

Collection of room amenity items available to the guest. Supported OTA specification RMA code. See OTA geoname data

Array<string>
includedAdultOccupancy
required

The number of pax the room price was meant for

integer format: int32
default: 2
includedChildOccupancy
required

The number of children the room price was meant for

integer format: int32
0
quantity
required

Number of identical room types.

integer format: int32
default: 1
bedroomConfiguration
required

Desired bedroom layout

object
identifier
required

Unique identifier

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

Name of layout

string
"" >= 1 characters
bedroomList
required

A room type can have more than one bedroom configuration.

Array<object>
>= 1 items
object
type
required

Type of bedroom

string
""
Allowed values: MASTER QUEEN JUNIOR DORMITORY BEDROOM_1 BEDROOM_2 BEDROOM_3 BEDROOM_4 BEDROOM_5 BEDROOM_6 BEDROOM_7 BEDROOM_8 BEDROOM_9 BEDROOM_10
bedList
required

A bedroom can have more than one bed type.

Array<object>
>= 1 items
object
bedTypeCode
required

Indicates the type of bed(s) found in the room. Typical values would be Double, Twin, Queen, or King. Supported OTA specification BED code. See OTA geoname data.

string
"" >= 1 characters
quantity
required

Number of beds for this bed type.

integer format: int32
"" >= 1
adults
required

The actual amount of adults as determined by the hotel’s policy.

integer format: int32
default: 2
children
required

The actual amount of children as determined by the hotel’s policy.

integer format: int32
0
startDate
required

Stay start date

string format: date
""
endDate
required

Stay end date

string format: date
""
roomRateIdentifier
required

Master rate identifier

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

Master rate internal name

string
"" >= 1 characters
ratePlan
required

Rate plan used for this stay

object
identifier
required

Rate plan identifier

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

Provides the name of the rate plan.

string
"" >= 1 characters
breakfast
required

When true, indicates breakfast is included.

boolean
brunch
required

When true, indicates brunch is included.

boolean
lunch
required

When true, indicates lunch is included.

boolean
dinner
required

When true, indicates dinner is included.

boolean
allInclusive
required

Everything included except alcohol

boolean
allInclusivePlusAlcohol
required

Everything included with alcohol

boolean
earlyCheckInCharge
lateCheckOutCharge
perkTypes

List of perks that came with the master rate

Array<object>
""
object
identifier
required

Enum identifier identifier for this perk. Makes the persistent version backwards compatible.

string
"" >= 1 characters
guaranteed

Whether perk is guaranteed or not.

boolean
level

The platform value of this perk.

integer format: int32
""
descriptions
required

Localized description for this perk

Array<object>
"" >= 1 items
object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters
sort

This is how perks get sorted when in a list

integer format: int32
""
activeCancellationPolicy
required

Based on the itinerary, the cancellation policy could be taken directly from the rate plan or it could be a policy exception also listed on the rate plan

object
identifier
required

Unique cancellation policy identifier

string format: uuid
""
hotelIdentifier
required

Property this cancellation is associated with

string format: uuid
""
refundable
required

Whether this cancellation policy is refundable or not

boolean
advanceCancellationFreeOfCharge

When the cancellation policy is refundable, this flag can be set and indicates there is more rules involved than just a no-questions-asked refundable.

string
""
Allowed values: UNTIL_EIGHTEEN_HUNDRED_HOURS_ON_DAY_OF_ARRIVAL UNTIL_FOURTEEN_HUNDRED_HOURS_ON_DAY_OF_ARRIVAL ONE_DAY_BEFORE_ARRIVAL TWO_DAYS_BEFORE_ARRIVAL THREE_DAYS_BEFORE_ARRIVAL FIVE_DAYS_BEFORE_ARRIVAL SEVEN_DAYS_BEFORE_ARRIVAL FOURTEEN_DAYS_BEFORE_ARRIVAL TWENTYONE_DAYS_BEFORE_ARRIVAL THIRTY_DAYS_BEFORE_ARRIVAL FOURTY_TWO_DAYS_BEFORE_ARRIVAL SIXTY_DAYS_BEFORE_ARRIVAL
refundableCancellationCharge

If advanceCancellationFreeOfCharge rules is not honored, this property explains what the guest will be charged.

string
""
Allowed values: FIRST_NIGHT THIRTY_PERCENT FIFTY_PERCENT SIXTY_PERCENT SEVENTY_PERCENT NINENTY_PERCENT ONE_HUNDRED_PERCENT
noShowCharge

In case the ‘Refundable cancellation charge’ is set, a different no show charge can be applied.

string
""
Allowed values: SAME_AS_CANCELLATION_FEE ONE_HUNDRED_PERCENT_OF_TOTAL_CHARGE
nonRefundableCancellationCharge

When the cancellation policy is non-refundable, this flag can be set and indicates there is more rules involved to calculate what the guest will owe in case of a cancellation.

string
""
Allowed values: FIRST_NIGHT TEN_PERCENT THIRTY_PERCENT FIFTY_PERCENT SEVENTY_PERCENT
nonRefundableDeadline

The non-refundable charge might can have a deadline. If that deadline passes, the guest might be charged more.

string
""
Allowed values: ONE_DAY_BEFORE_ARRIVAL TWO_DAYS_BEFORE_ARRIVAL THREE_DAYS_BEFORE_ARRIVAL FIVE_DAYS_BEFORE_ARRIVAL SEVEN_DAYS_BEFORE_ARRIVAL FOURTEEN_DAYS_BEFORE_ARRIVAL TWENTYONE_DAYS_BEFORE_ARRIVAL THIRTY_DAYS_BEFORE_ARRIVAL FOURTY_TWO_DAYS_BEFORE_ARRIVAL SIXTY_DAYS_BEFORE_ARRIVAL
nonRefundableAfterDeadlineCancellationCharge

If the guest does not honor the non-refundable deadline rule, this charge dictates what she owes after the deadline passes.

string
""
Allowed values: FIRST_NIGHT TEN_PERCENT THIRTY_PERCENT FIFTY_PERCENT SEVENTY_PERCENT ONE_HUNDRED_PERCENT
policyCode
string
ancillaryList

Ancillary services attached to this room stay.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
roomImageUrl

Absolute URL of room image

string
""
guests
integer format: int32
roomNights

Total number of nights the guest stays at the hotel. -1 indicates there is an error.

integer format: int64
""
specialRequests

Free text where the traveler can add a message to the property.

string
""
comment
string
hotelImageUrl
required

Absolute URL of hotel image that can be used as-is

string
""
roomImageUrl
required

Absolute URL of room image that can be used as-is

string
""
ancillaryList
Array<object>
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
hasAddOns

Convenience data point to check if any add-on offers are in this booking.

boolean
hasBreakfast

Convenience data point to get to breakfast quickly.

boolean
hasBrunch

Convenience data point to get to brunch quickly.

boolean
hasLunch

Convenience data point to get to lunch quickly.

boolean
hasDinner

Convenience data point to get to dinner quickly.

boolean
hasAllInclusive

Convenience data point to get to all-inclusive quickly.

boolean
hasAllInclusivePlusAlcohol

Convenience data point to get to all-inclusive with alcohol quickly.

boolean
hasRoomTypeAncillaries

Convenience data point to check if any room type ancillaries are in this booking.

boolean
hasFood

Convenience data point to check if any food is included in this booking.

boolean
hasRestaurants

Convenience data point to check if any restaurant reservations are included in this booking.

boolean
hasMeetingRooms

Convenience data point to check if any meeting room reservations are included in this booking.

boolean
hasSpas

Convenience data point to check if any spa reservations are included in this booking.

boolean
hasActivities

Convenience data point to check if any activity reservations are included in this booking.

boolean
hasAttractions

Convenience data point to check if any attractions reservations are included in this booking.

boolean
hasPlaces

Convenience data point to check if any place reservations are included in this booking.

boolean
meetingRooms

Meeting room reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
restaurants

Restaurant reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
spas

Spa reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
activities

Activity reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
attractions

Attraction reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
places

Place reservation records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
roomTypeAncillaries

Room type ancillary records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
addOns

Add-on records.

Array<object>
""
object
name
required

Name of inventory

string
"" >= 1 characters
type
required

Inventory type

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
startDate

Date start time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
endDate

Date end time when reservation was made for. Optional — null for ancillaries with no specific schedule.

string format: date-time
""
attendees
required

Number of guests that are part of this reservation.

integer format: int32
default: 1
imageIdentifier
required

Cloudinary image identifier

string
"" >= 1 characters
imageUrl
required

Absolute URL to image of blocking

string
"" >= 1 characters
localizedName
required

Name of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
localizedDescription
required

Description of travel inventory in traveler language (if available). Defaults to English.

string
"" >= 1 characters
Example
{
"id": "",
"createdDate": "",
"lastUpdate": "",
"version": "",
"creation": "NORMAL",
"cancelled": false,
"groupIdentifier": "",
"customization": "",
"bookingCode": "",
"user": "",
"userSession": "",
"serverUrl": "",
"socials": "",
"review": "",
"emailHeaderLogoUrl": "",
"logoIdentifier": "",
"hotel": "",
"roomStay": "",
"specialRequests": "",
"hotelImageUrl": "",
"roomImageUrl": "",
"ancillaryList": [
{
"name": "",
"type": "ROOM_TYPE_ANCILLARY",
"startDate": "",
"endDate": "",
"attendees": 1,
"imageIdentifier": "",
"imageUrl": "",
"localizedName": "",
"localizedDescription": ""
}
],
"hasAddOns": false,
"hasBreakfast": false,
"hasBrunch": false,
"hasLunch": false,
"hasDinner": false,
"hasAllInclusive": false,
"hasAllInclusivePlusAlcohol": false,
"hasRoomTypeAncillaries": false,
"hasFood": false,
"hasRestaurants": false,
"hasMeetingRooms": false,
"hasSpas": false,
"hasActivities": false,
"hasAttractions": false,
"hasPlaces": false,
"meetingRooms": "",
"restaurants": "",
"spas": "",
"activities": "",
"attractions": "",
"places": "",
"roomTypeAncillaries": "",
"addOns": ""
}

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"
}
}

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

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

Internal Server Error

object
Example generated
{}