Skip to content

Show Property List

POST
/api/public/{managingEntityIdentifier}/inventory/list
curl --request POST \
--url 'https://api.wink.travel/api/public//inventory/list?customizationIdentifier=&images=&videos=' \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data null

Show property content / availability / rate details.

managingEntityIdentifier
required
string
""

Managing entity identifier

customizationIdentifier
string
""

Customization identifier

images
string
""

Number of images to return for inventory

videos
string
""

Number of videos to return for inventory

Wink-Version
string
default: 2.0.0
Allowed values: 2.0
Media type application/json

Wrapper to query for multiple property inventories

object
list
required
Array<object>
>= 1 items <= 20 items

Multiple requests for property inventory

object
hotelIdentifier

Unique property identifier to retrieve inventory for. Either the hotelIdentifier or urlName property is required.

string format: uuid
""
Example
hotel-1
urlName

Unique url-friendly record identifier of property. Either the hotelIdentifier or urlName property is required.

string
""
Example
the-most-fantastic-hotel
showHotel

Flag to indicate whether to return basic property data. If you are loading up property for the first time, this data would be good to include. But there is no need to load that a second time if you are only going for availability data. This field populates hotel data in response.

boolean
default: true
Example
true
showRoomTypes

Flag to indicate whether to return property room type data. This field populates roomType, cheapesRoomTypes and available data in response.

boolean
default: true
Example
true
showMetadata

Flag to indicate whether to return property meta data. This field populates metadata data in response.

boolean
default: true
Example
true
showVideos

Flag to indicate whether to return property video data. This field populates videos data in response.

boolean
Example
true
showImages

Flag to indicate whether to return property image data. This field populates images data in response.

boolean
Example
true
showAddOnOffers

Flag to indicate whether to return property add-on data. This field populates roomTypes.priceConfigurations.addOnOffers data in response.

boolean
Example
true
showRestaurants

Flag to indicate whether to return property restaurant data. This field populates restaurants data in response.

boolean
Example
true
showMeetingRooms

Flag to indicate whether to return property meeting room data. This field populates meetingRooms data in response.

boolean
Example
true
showSpas

Flag to indicate whether to return property spa data. This field populates spas data in response.

boolean
Example
true
showAttractions

Flag to indicate whether to return property attraction data. This field populates attractions data in response.

boolean
Example
true
showActivities

Flag to indicate whether to return property activity data. This field populates activities data in response.

boolean
Example
true
showPlaces

Flag to indicate whether to return property place data. This field populates places data in response.

boolean
Example
true
showRecognition

Flag to indicate whether to return property recognition data. This field populates recognitions data in response.

boolean
Example
true
showAggregateGreenIndexScores

Flag to indicate whether to return property green index score data. This field populates greenIndexScores data in response. Note: You only need to return hotel data to get the overall aggregate Green Index score and not detailed category scores.

boolean
Example
true
showAnnouncements

Flag to indicate whether to return property announcement data. Announcements are messages the property wishes to convey to travelers for certain dates. This field populates announcements data in response.

boolean
Example
true
showReviews

Flag to indicate whether to return property review data. Note: You only need to return hotel data to get the overall aggregate review score and not the entire list of reviews. This field populates reviews data in response.

boolean
Example
true
userSession
required

Returns the same user session that was sent by the caller.

object
itinerary
required

Dates and travel info.

object
startDate
required

Start date of itinerary

string format: date
""
Example
2024-01-01
endDate

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

string format: date
""
Example
2024-01-02
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
required

Room configurations

Array<object>
>= 1 items <= 2147483647 items

Room Configuration

object
adults
required

Number of adults

integer format: int32
default: 1 >= 1
Example
2
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
Example
1
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
""
Example
en
currency

User’s currency preference

string
""
Example
USD
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

OK

Media type application/json
object
list
Array<object>

Unique property detail response.

object
hotelIdentifier

Unique property identifier to retrieve inventory for.

string format: uuid
""
urlName

Unique url-friendly record identifier of property.

string
""
uniqueId

Unique short ID.

string
""
hotel

Property details

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
greenIndexScores

Detailed Green Index scores on hoe the property scores by category

object
hotelIdentifier
required
string
list
required
Array<object>
object
questionKey
string
value
integer format: int32
highScore
required

The highest possible score from all questions

integer format: int32
""
totalScore
required

The total score from all questions answered

integer format: int32
""
aggregateScore
required

Total score divided by high score

number format: float
"" <= 1
scoresByCategory
required

Aggregate scores by Green Index category

Array<object>
object
category
required

Green Index category

string
""
Allowed values: GENERAL ENERGY WATER PURCHASING WASTE SITE
highScore
required

The highest possible score from all questions within this category

integer format: int32
""
totalScore
required

The total score from all questions answered within this category

integer format: int32
""
aggregateScore
required

Total score divided by high score within this category

number format: float
"" <= 1
roomTypes

List of room types with price configurations based on the itinerary that was passed on the user session.

Array<object>
""
object
room
required

The room type.

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
priceConfigurations
required
Array<object>

The different price configurations available for this room type.

object
channelInventoryIdentifier
required

Sales channel inventory identifier

string
""
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
commissionable
required

Whether this package is commissionable based on the incoming sales channel.

boolean
commission
required

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
adults
required

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

integer format: int32
""
children

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

integer format: int32
""
startDate
required

SimpleDateTimeItinerary startDate

string format: date
""
endDate
required

SimpleDateTimeItinerary endDate

string format: date
""
roomRateIdentifier
required

Specified master rate identifier

string
""
roomRateInternalName
required

Specified master rate internal name

string
""
ratePlan
required

Specified rate plan

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
Array<object>

Perks that accompany the master rate

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
""
price
required

Calculated price

object
userSpecifiedCurrencyBaseTotal

Base total in user specified currency.

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

Base total in hotel’s currency.

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

Base total in wink currency.

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

Extra person modifier in hotel currency.

number
""
internalExtraPaxModifier

Extra person modifier in wink currency

number
""
userSpecifiedCurrencyExtraPaxModifier

Extra person modifier in user specified currency

number
""
sourceExtraChildModifier

Extra child modifier in hotel currency

number
""
internalExtraChildModifier

Extra child modifier in wink currency

number
""
userSpecifiedCurrencyExtraChildModifier

Extra child modifier in user specified currcency

number
""
sourceSingleOccupantModifier

Single occupant modifier in hotel currency

number
""
internalSingleOccupantModifier

Singe occupant modifier in wink currency

number
""
userSpecifiedCurrencySingleOccupantModifier

Single occupant modifier in user specified currency

number
""
sourcePromotionalModifier

Rate discount modifiers in hotel currency

number
""
internalPromotionalModifier

Rate discount modifiers in wink currency

number
""
userSpecifiedCurrencyPromotionalModifier

Rate discount modifiers in user specified currency

number
""
sourcePremiumModifier

Rate premiums modifiers in hotel currency

number
""
internalPremiumModifier

Rate premiums modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Rate premiums modifiers in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
quantity

Quantity

integer format: int32
""
minOccupancy

Minimum occupancy

integer format: int32
""
maxOccupancy

Maximum occupancy

integer format: int32
""
rateSource

Source

string
""
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Chanel discount percent

number
""
premiumPercent

Premium percent

number
""
available

Available

boolean
sourceToUserCurrencyQuote

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
offerDetails

Localized text of the discount

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
promotionalCodes

Promotional codes

Array<string>
userSpecifiedCurrencyTotal

User-defined currency final price.

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

Source currency final price.

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

Internal currency final price.

object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
extraCharges

Per rate plan level extra charges with localized prices

object
items
Items

List of extra charges that applies to the rate plan.

Array<object>
""
object
ratePlanLevelFee

What the guest is paying extra for

object
descriptions
required

List of localized descriptions for this fee.

Array<object>
"" >= 1 items
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
fixedAmount
required

Rate plan level fixed fee amount in property currency

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

Rate plan fee type

string
""
Allowed values: PER_DAY PER_STAY PER_PERSON_PER_DAY PER_PERSON_PER_STAY
unitPrice

The localized unit price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
price

The localized price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
configuration
required

The selected room configuration that created this record

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
addOnOffers
Array<object>

Add-ons that are available with this room configuration

object
addOn
required

The original add-on record created by the property.

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
numberOfUnits
required

Total number of add-ons available to purchase.

integer format: int32
0
mandatory
required

Make this add-on mandatory for all guests by enabling this flag.

boolean
ratePlanIdentifier

Optional restriction on rate plan.

string
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
perkValue

The combined value of these perkTypes

integer format: int32
""
activeCancellationPolicy
required

The active / selected cancellation policy for this room configuration

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
roomNights
required

Number of nights the guests will be staying

integer format: int32
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
rateSource
string
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
available
boolean
lowestPrice
object
channelInventoryIdentifier
required

Sales channel inventory identifier

string
""
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
commissionable
required

Whether this package is commissionable based on the incoming sales channel.

boolean
commission
required

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
adults
required

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

integer format: int32
""
children

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

integer format: int32
""
startDate
required

SimpleDateTimeItinerary startDate

string format: date
""
endDate
required

SimpleDateTimeItinerary endDate

string format: date
""
roomRateIdentifier
required

Specified master rate identifier

string
""
roomRateInternalName
required

Specified master rate internal name

string
""
ratePlan
required

Specified rate plan

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
Array<object>

Perks that accompany the master rate

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
""
price
required

Calculated price

object
userSpecifiedCurrencyBaseTotal

Base total in user specified currency.

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

Base total in hotel’s currency.

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

Base total in wink currency.

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

Extra person modifier in hotel currency.

number
""
internalExtraPaxModifier

Extra person modifier in wink currency

number
""
userSpecifiedCurrencyExtraPaxModifier

Extra person modifier in user specified currency

number
""
sourceExtraChildModifier

Extra child modifier in hotel currency

number
""
internalExtraChildModifier

Extra child modifier in wink currency

number
""
userSpecifiedCurrencyExtraChildModifier

Extra child modifier in user specified currcency

number
""
sourceSingleOccupantModifier

Single occupant modifier in hotel currency

number
""
internalSingleOccupantModifier

Singe occupant modifier in wink currency

number
""
userSpecifiedCurrencySingleOccupantModifier

Single occupant modifier in user specified currency

number
""
sourcePromotionalModifier

Rate discount modifiers in hotel currency

number
""
internalPromotionalModifier

Rate discount modifiers in wink currency

number
""
userSpecifiedCurrencyPromotionalModifier

Rate discount modifiers in user specified currency

number
""
sourcePremiumModifier

Rate premiums modifiers in hotel currency

number
""
internalPremiumModifier

Rate premiums modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Rate premiums modifiers in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
quantity

Quantity

integer format: int32
""
minOccupancy

Minimum occupancy

integer format: int32
""
maxOccupancy

Maximum occupancy

integer format: int32
""
rateSource

Source

string
""
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Chanel discount percent

number
""
premiumPercent

Premium percent

number
""
available

Available

boolean
sourceToUserCurrencyQuote

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
offerDetails

Localized text of the discount

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
promotionalCodes

Promotional codes

Array<string>
userSpecifiedCurrencyTotal

User-defined currency final price.

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

Source currency final price.

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

Internal currency final price.

object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
extraCharges

Per rate plan level extra charges with localized prices

object
items
Items

List of extra charges that applies to the rate plan.

Array<object>
""
object
ratePlanLevelFee

What the guest is paying extra for

object
descriptions
required

List of localized descriptions for this fee.

Array<object>
"" >= 1 items
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
fixedAmount
required

Rate plan level fixed fee amount in property currency

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

Rate plan fee type

string
""
Allowed values: PER_DAY PER_STAY PER_PERSON_PER_DAY PER_PERSON_PER_STAY
unitPrice

The localized unit price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
price

The localized price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
configuration
required

The selected room configuration that created this record

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
addOnOffers
Array<object>

Add-ons that are available with this room configuration

object
addOn
required

The original add-on record created by the property.

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
numberOfUnits
required

Total number of add-ons available to purchase.

integer format: int32
0
mandatory
required

Make this add-on mandatory for all guests by enabling this flag.

boolean
ratePlanIdentifier

Optional restriction on rate plan.

string
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
perkValue

The combined value of these perkTypes

integer format: int32
""
activeCancellationPolicy
required

The active / selected cancellation policy for this room configuration

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
roomNights
required

Number of nights the guests will be staying

integer format: int32
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
rateSource
string
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
available
boolean
available
boolean
meetingRooms

List of property meeting rooms on and off the premises.

Array<object>
""
object
meetingRoom

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
irregular
required

Room has an irregular shape. If true, the room would be of a traditional square or rectangular shape.

boolean
meetingRoomCapacity
required

The total number of people permitted in the meeting room.

integer format: int32
0
access

The type of access to the meeting space.

string
default: MEETING_ROOM_ACCESS_PRIVATE
meetingRoomTypeCode
required

Supported OTA specification MRF code. See OTA geoname data.

string
"" >= 1 characters
meetingRoomLevel

Defines the level in the facility where the meeting room is located.

string
""
dedicatedInd
required

When true, the room is used for a single purpose as indicated by the MeetingRoomTypeCode attribute.

boolean
area
required

Area (in square meters) of this meeting room.

number format: float
"" >= 1
height
required

Height (in meters) of this meeting room.

number format: float
"" >= 1
width
required

Width (in meters) of this meeting room.

number format: float
"" >= 1
length
required

Length (in meters) of this meeting room.

number format: float
"" >= 1
amenities

Supported OTA specification MRC code. See OTA geoname data.

Array<string>
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
restaurants

List of property restaurants on and off the premises.

Array<object>
""
object
restaurant

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
maxSeatingCapacity
required

Restaurant supports these many people.

integer format: int32
"" >= 1
maxSingleParty
required

Largest table at restaurant.

integer format: int32
"" >= 1
offerBreakfast
required

Restaurant offers breakfast.

boolean
offerLunch
required

Restaurant offers lunch.

boolean
offerDinner
required

Restaurant offers dinner.

boolean
offerBrunch
required

Restaurant offers brunch.

boolean
amenities

Supported OTA specification RSI code. See OTA geoname data.

Array<string>
infoCodes

Supported OTA specification RES code. See OTA geoname data.

Array<string>
cuisineCodes

Supported OTA specification CUI code. See OTA geoname data.

Array<string>
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
spas

List of property spas on and off the premises.

Array<object>
""
object
spa

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
amenities

UnSupported OTA specification SPA code. See OTA geoname data.

Array<string>
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
activities

List of property activities on and off the premises.

Array<object>
""
object
activity

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
recreationCategoryCode
required

Supported OTA specification RST code. See OTA geoname data

string
"" >= 1 characters
amenities

Supported OTA specification REC code. See OTA geoname data.

Array<string>
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
attractions

List of property attractions on and off the premises.

Array<object>
""
object
attraction

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
attractionCategoryCode
required

Supported OTA specification ACC code. See OTA geoname data

string
"" >= 1 characters
courtesyPhone

Whether or not a courtesy phone for contacting the hotel is available at the attraction (e.g. often times these are available in airports). When true, the phone is available.

boolean
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
places

List of property places on and off the premises.

Array<object>
""
object
place

Inventory data object

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
refPointCategoryCode
required

Supported OTA specification REF code. See OTA geoname data.

string
""
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
metadata

List of property meta data.

Array<object>
""
object
type
string
Allowed values: PAGE_TITLE METADATA
key
string
value
string
images

List of 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

List of 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
recognitions

List of property recognitions

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

List of property announcements

Array<object>
""
object
startDate

Start date for when announcement is valid

string format: date
""
endDate

End date for when announcement is no longer valid

string format: date
""
descriptions
required

List of all localized announcements.

Array<object>
>= 1 items <= 2147483647 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
showTitle

When enabled, the property does not want the title to be displayed

boolean
showAlways

When enabled, the property wants this announcement always to be displayed

boolean
reviews

List of property reviews

Array<object>
""
object
reviewBy

User details of creator of booking.

string
""
reviewedOn

Date of review.

string format: date-time
""
averageScore

Total points divided by number of questions.

number format: double
""
answers

List of reviewBy review answers.

Array<object>
object
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
""
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
""
review

Free text record created by traveler

string
""
likes

List of member identifiers who liked the reviewual review

integer format: uuid
""
salesChannel

Sales channel that owns this booking

object
name
required

Name of sales channel

string
"" >= 1 characters
channelDiscountPercent

A percent discount the property gave the sales channel. Value between 0.0 - 1.0.

number format: float
0
commissionPercent

A percent commission the property gave the sales channel. Value between 0.0 - 1.0.

number format: float
0
cheapestRoomTypes

Uses the content from roomTypes and displays the lowest price for each room type that is available.

Array<object>
""
object
room
required

The room type

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
price

Price if available

object
channelInventoryIdentifier
required

Sales channel inventory identifier

string
""
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
commissionable
required

Whether this package is commissionable based on the incoming sales channel.

boolean
commission
required

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
adults
required

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

integer format: int32
""
children

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

integer format: int32
""
startDate
required

SimpleDateTimeItinerary startDate

string format: date
""
endDate
required

SimpleDateTimeItinerary endDate

string format: date
""
roomRateIdentifier
required

Specified master rate identifier

string
""
roomRateInternalName
required

Specified master rate internal name

string
""
ratePlan
required

Specified rate plan

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
Array<object>

Perks that accompany the master rate

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
""
price
required

Calculated price

object
userSpecifiedCurrencyBaseTotal

Base total in user specified currency.

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

Base total in hotel’s currency.

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

Base total in wink currency.

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

Extra person modifier in hotel currency.

number
""
internalExtraPaxModifier

Extra person modifier in wink currency

number
""
userSpecifiedCurrencyExtraPaxModifier

Extra person modifier in user specified currency

number
""
sourceExtraChildModifier

Extra child modifier in hotel currency

number
""
internalExtraChildModifier

Extra child modifier in wink currency

number
""
userSpecifiedCurrencyExtraChildModifier

Extra child modifier in user specified currcency

number
""
sourceSingleOccupantModifier

Single occupant modifier in hotel currency

number
""
internalSingleOccupantModifier

Singe occupant modifier in wink currency

number
""
userSpecifiedCurrencySingleOccupantModifier

Single occupant modifier in user specified currency

number
""
sourcePromotionalModifier

Rate discount modifiers in hotel currency

number
""
internalPromotionalModifier

Rate discount modifiers in wink currency

number
""
userSpecifiedCurrencyPromotionalModifier

Rate discount modifiers in user specified currency

number
""
sourcePremiumModifier

Rate premiums modifiers in hotel currency

number
""
internalPremiumModifier

Rate premiums modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Rate premiums modifiers in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
quantity

Quantity

integer format: int32
""
minOccupancy

Minimum occupancy

integer format: int32
""
maxOccupancy

Maximum occupancy

integer format: int32
""
rateSource

Source

string
""
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Chanel discount percent

number
""
premiumPercent

Premium percent

number
""
available

Available

boolean
sourceToUserCurrencyQuote

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
offerDetails

Localized text of the discount

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
promotionalCodes

Promotional codes

Array<string>
userSpecifiedCurrencyTotal

User-defined currency final price.

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

Source currency final price.

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

Internal currency final price.

object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
extraCharges

Per rate plan level extra charges with localized prices

object
items
Items

List of extra charges that applies to the rate plan.

Array<object>
""
object
ratePlanLevelFee

What the guest is paying extra for

object
descriptions
required

List of localized descriptions for this fee.

Array<object>
"" >= 1 items
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
fixedAmount
required

Rate plan level fixed fee amount in property currency

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

Rate plan fee type

string
""
Allowed values: PER_DAY PER_STAY PER_PERSON_PER_DAY PER_PERSON_PER_STAY
unitPrice

The localized unit price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
price

The localized price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
configuration
required

The selected room configuration that created this record

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
addOnOffers
Array<object>

Add-ons that are available with this room configuration

object
addOn
required

The original add-on record created by the property.

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
numberOfUnits
required

Total number of add-ons available to purchase.

integer format: int32
0
mandatory
required

Make this add-on mandatory for all guests by enabling this flag.

boolean
ratePlanIdentifier

Optional restriction on rate plan.

string
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
perkValue

The combined value of these perkTypes

integer format: int32
""
activeCancellationPolicy
required

The active / selected cancellation policy for this room configuration

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
roomNights
required

Number of nights the guests will be staying

integer format: int32
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
rateSource
string
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
available
boolean
available
boolean
lowestPrice

Uses the content from roomTypes and shows the room type with the lowest price.

object
room
required

The room type

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
price

Price if available

object
channelInventoryIdentifier
required

Sales channel inventory identifier

string
""
list
Array<object>

This is one localized bookable item that can stand alongside a restaurant / meeting room etc.

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
commissionable
required

Whether this package is commissionable based on the incoming sales channel.

boolean
commission
required

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
adults
required

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

integer format: int32
""
children

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

integer format: int32
""
startDate
required

SimpleDateTimeItinerary startDate

string format: date
""
endDate
required

SimpleDateTimeItinerary endDate

string format: date
""
roomRateIdentifier
required

Specified master rate identifier

string
""
roomRateInternalName
required

Specified master rate internal name

string
""
ratePlan
required

Specified rate plan

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
Array<object>

Perks that accompany the master rate

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
""
price
required

Calculated price

object
userSpecifiedCurrencyBaseTotal

Base total in user specified currency.

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

Base total in hotel’s currency.

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

Base total in wink currency.

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

Extra person modifier in hotel currency.

number
""
internalExtraPaxModifier

Extra person modifier in wink currency

number
""
userSpecifiedCurrencyExtraPaxModifier

Extra person modifier in user specified currency

number
""
sourceExtraChildModifier

Extra child modifier in hotel currency

number
""
internalExtraChildModifier

Extra child modifier in wink currency

number
""
userSpecifiedCurrencyExtraChildModifier

Extra child modifier in user specified currcency

number
""
sourceSingleOccupantModifier

Single occupant modifier in hotel currency

number
""
internalSingleOccupantModifier

Singe occupant modifier in wink currency

number
""
userSpecifiedCurrencySingleOccupantModifier

Single occupant modifier in user specified currency

number
""
sourcePromotionalModifier

Rate discount modifiers in hotel currency

number
""
internalPromotionalModifier

Rate discount modifiers in wink currency

number
""
userSpecifiedCurrencyPromotionalModifier

Rate discount modifiers in user specified currency

number
""
sourcePremiumModifier

Rate premiums modifiers in hotel currency

number
""
internalPremiumModifier

Rate premiums modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Rate premiums modifiers in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
quantity

Quantity

integer format: int32
""
minOccupancy

Minimum occupancy

integer format: int32
""
maxOccupancy

Maximum occupancy

integer format: int32
""
rateSource

Source

string
""
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Chanel discount percent

number
""
premiumPercent

Premium percent

number
""
available

Available

boolean
sourceToUserCurrencyQuote

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
offerDetails

Localized text of the discount

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
promotionalCodes

Promotional codes

Array<string>
userSpecifiedCurrencyTotal

User-defined currency final price.

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

Source currency final price.

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

Internal currency final price.

object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
extraCharges

Per rate plan level extra charges with localized prices

object
items
Items

List of extra charges that applies to the rate plan.

Array<object>
""
object
ratePlanLevelFee

What the guest is paying extra for

object
descriptions
required

List of localized descriptions for this fee.

Array<object>
"" >= 1 items
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
fixedAmount
required

Rate plan level fixed fee amount in property currency

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

Rate plan fee type

string
""
Allowed values: PER_DAY PER_STAY PER_PERSON_PER_DAY PER_PERSON_PER_STAY
unitPrice

The localized unit price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
price

The localized price of the extra charge

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
configuration
required

The selected room configuration that created this record

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
addOnOffers
Array<object>

Add-ons that are available with this room configuration

object
addOn
required

The original add-on record created by the property.

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

Start month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a starting date.

string format: date
""
applicableEnd

End month and day or date for which the attraction (e.g. the start of a season) is available. This date property signifies that the blocking is recurring and / or seasonal. If the date is in the past, only day and month will be used to infer seasonality. If the date is a future date, it will be interpreted as a ending date.

string format: date
""
reservationRequiredInd

Indicates whether a reservation is required to participate in this blocking.

boolean
opens

Opening time of blocking (if applicable). Leave empty if blocking is always available.

string
""
closes

Closing time of blocking (if applicable). Leave empty if blocking is always available.

string
""
daysOfWeek

Indicate which days this blocking is open.

object
mon

Set to true to enable Monday.

boolean
tue

Set to true to enable Tuesday.

boolean
wed

Set to true to enable Wednesday.

boolean
thu

Set to true to enable Thursday.

boolean
fri

Set to true to enable Friday.

boolean
sat

Set to true to enable Saturday.

boolean
sun

Set to true to enable Sunday.

boolean
disabled

Convenience property to quickly determine if this existing object has any active days enabled.

boolean
numberOfUnits
required

Total number of add-ons available to purchase.

integer format: int32
0
mandatory
required

Make this add-on mandatory for all guests by enabling this flag.

boolean
ratePlanIdentifier

Optional restriction on rate plan.

string
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
channelInventoryIdentifier

Channel inventory identifier referencing this record.

string format: uuid
""
commissionable

Whether this package is commissionable based on the incoming sales channel.

boolean
commission

The commission percentage.

number format: float
""
direct
required

Indicates whether the blocking from sales channel is direct or not. If you are a travel agent doing your own acquiring, this flag has to be true to make a booking.

boolean
perkValue

The combined value of these perkTypes

integer format: int32
""
activeCancellationPolicy
required

The active / selected cancellation policy for this room configuration

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
roomNights
required

Number of nights the guests will be staying

integer format: int32
""
priceList
Array<object>

Localized transactional blocking

object
identifier
required

Unique transactional identifier

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

Internal name of transactional blocking.

string
"" >= 1 characters
descriptions
required

Localized descriptions describing inventory.

Array<object>
>= 1 items <= 2147483647 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
pricingType
required

How this blocking item should be priced.

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
price
required

Localized price

object
sourceToUserCurrencyQuote
required

Hotel to user currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
sourceToInternalCurrencyQuote
required

Hotel to wink currency exchange rate.

object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
userSpecifiedCurrencyBaseTotal
required

Base total in user specified currency.

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

Base total in hotel currency.

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

Base total in wink currency.

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

Promotional modifiers in user specified currency

number
""
sourcePromotionalModifier

Promotional modifiers in hotel currency

number
""
internalPromotionalModifier

Promotional modifiers in wink currency

number
""
userSpecifiedCurrencyPremiumModifier

Premium modifiers in user specified currency

number
""
sourcePremiumModifier

Premium modifiers in hotel currency

number
""
internalPremiumModifier

Premium modifiers in wink currency

number
""
userSpecifiedCurrencyChannelModifier

Channel / Membership modifier in user specified currency

number
""
sourceChannelModifier

Channel / Membership modifier in hotel currency

number
""
internalChannelModifier

Channel / Membership modifier in wink currency

number
""
quantity

How many of this item is included in this price

integer format: int64
default: 1
promotionalDiscountPercent

Promotional discount percent

number
""
channelDiscountPercent

Channel discount percent

number
""
premiumPercent

Premium percent

number
""
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
hasChannelDiscount
boolean
hasPremium
boolean
hasPromotion
boolean
multimedias
required

List of images / videos of item.

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
minPax

Whether there is a limit to minimum group size.

integer format: int32
""
maxPax

Whether there is a limit to maximum group size.

integer format: int32
""
offerDetails

Localized offer details if rate plan discount applies.

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
promotion

If a package is linked to a rate plan the user could be entitled to a promotional discount if she enters a code. When this field is populated, it means the discount was applied to the package.

string
""
rateSource
string
sourceTotal
object
amount
required
number
currency
required
string
>= 1 characters
internalTotal
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyTotal
object
amount
required
number
currency
required
string
>= 1 characters
available
boolean
available
boolean
available
boolean
Example
{
"list": [
""
]
}

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