Skip to content

Test Rate / Availability

POST
/api/managing-entity/{managingEntityIdentifier}/extranet/sandbox/room/list
curl --request POST \
--url https://api.wink.travel/api/managing-entity/hotel-1/extranet/sandbox/room/list \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data '""'

Test whether the rates and availability for a sales channel is coming backing the way the property wants

managingEntityIdentifier
required
string
""

Display available room for property ID

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

Rate request body

string
""

OK

Media type application/json
Array<object>
object
identifier
string
roomName
string
accessibleMasterRates
Array<object>
object
id

Document UUID

string
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

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

integer format: int64
""
hotelIdentifier
required

Hotel identifier.

string format: uuid
""
name
required

Internal name of master rate. The name is generated by guest room and rate plan names respectively.

string
""
roomType
required
object
identifier
required

Room type ID

string
"" >= 1 characters
hotelIdentifier
required

Hotel ID

string
"" >= 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 inventory 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 inventory 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
multimedias
required

List of images / videos of inventory.

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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 inventory (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 inventory.

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 inventory in a list of activities.

integer format: int32
""
minAgeAppropriateCode

Supported OTA specification AQC code. See OTA geoname data

string
""
bookable
required

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

boolean
default: true
active
required

Modify inventory 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 inventory (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
""
transactionalInventoryList

Purchasable items for this inventory.

Array<object>

This is one 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
basePrice
required

Base price of booking this blocking.

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

If you are selling this blocking at a discount, indicate the discounted selling price. Leave empty if there is no discount.

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

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
percentDiscount

Calculates the percent difference between basePrice and discountedPrice.

number
""
percentPremium

Calculates the percent difference between basePrice and discountedPrice.

number
""
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
baseRate
required

Typical one night rate during regular remand period

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

Typical one night rate in a distressed period

object
amount
required
number
currency
required
string
>= 1 characters
ratePlan
required
object
identifier
required

Rate plan identifier

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

Hotel ID

string
"" >= 1 characters
name
required

Provides the name of the rate plan.

string
"" >= 1 characters
prepaid
required

When true, indicates if the rate is a prepaid rate.

boolean
enabled
required

Whether rate plan is active or not.

boolean
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
sellStartDate

Set a start date for when to start selling this rate. When sellStartDate and sellEndDate are set, this rate is only available for sale within that date range.

string format: date
""
sellEndDate

Set an end date for when to finish selling this rate. When sellStartDate and sellEndDate are set, this rate is only available for sale within that date range.

string format: date
""
stayStartDate

Set a start date for when the guest can visit. When stayStartDate and stayEndDate are set, this rate is only available for stay within that date range.

string format: date
""
stayEndDate

Set an end date for when the guest can visit. When stayStartDate and stayEndDate are set, this rate is only available for stay within that date range.

string format: date
""
loyaltyPointsAccrue

Property honors loyalty points with this rate plan.

boolean
maxAdvanceBookingOffset

Maximum days before the arrival date for which this rate plan may be booked.

integer format: int32
""
minAdvanceBookingOffset

Minimum days before the arrival date for which this rate plan may be booked.

integer format: int32
""
minTotalOccupancy

Defines the minimum number of total occupants required for this rate plan.

integer format: int32
""
maxTotalOccupancy

Defines the maximum number of total occupants required for this rate plan.

integer format: int32
""
minLOS

Indicates the minimum length of stay required for this rate plan.

integer format: int32
""
maxLOS

Indicates the maximum length of stay.

integer format: int32
""
minAge

The minimum age to qualify for this rate plan.

integer format: int32
""
maxAge

The maximum age to qualify for this rate plan.

integer format: int32
""
ratePlanLevelFees

This can be a one-time fee such as a cleaning fee

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

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
availableDaysOfWeek
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
arrivalDaysOfWeek
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
departureDaysOfWeek
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
requiredDaysOfWeek
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
earlyCheckInCharge
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

The cancellation policy for this rate plan.

object
identifier
required

Unique cancellation policy identifier

string format: uuid
""
hotelIdentifier
required

Property this cancellation is associated with

string format: uuid
""
refundable
required

Whether this cancellation policy is refundable or not

boolean
advanceCancellationFreeOfCharge

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

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

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

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

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

string
""
Allowed values: SAME_AS_CANCELLATION_FEE ONE_HUNDRED_PERCENT_OF_TOTAL_CHARGE
nonRefundableCancellationCharge

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

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

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

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

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

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

Allows a property to dynamically use another cancellation policy for a specific date range

object
list
required

List of cancellation policy exceptions

Array<object>
>= 1 items
object
cancellationPolicyIdentifier
required

Cancellation policy

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

Cancellation policy

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

Start date for when this cancellation policy should start to override the default cancellation policy.

string format: date
""
endDate
required

End date for when this cancellation policy should end overriding the default cancellation policy.

string format: date
""
singleOccupancyRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

Flag to enable / disable master rate across all sales channels

boolean
default: true
perkTypes
Array<object>

The perks associated with this 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
sort

This is how perks get sorted when in a list

integer format: int32
""
inaccessibleMasterRates
Array<object>
object
identifier
string
name
string
map
object
key
additional properties
string
reasons
Array<string>
accessibleInventory
Array<object>
object
id

Document UUID

string
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

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

integer format: int64
""
salesChannel
required

Parent sales channel

object
identifier
required

Unique record identifier of this segment / account

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

Channel is owned by this supplier identifier.

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

Name of property / supplier that owns this channel

string
"" >= 1 characters
supplierAvailable
required

Flag when supplier not available. E.g. Hotel disables property

boolean
default: true
subType
required

What type of segment of channel is this.

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

A specific identifier for the company / corporation / travel agency that is retrieving the rates

string format: uuid
""
ownerName

Name of the owner / affiliate. Hotel booking customization when it’s the booking customization.

string
""
enabled

Flag the supplier can use to enable / disable this channel

boolean
default: true
channelDisabled

System override by supplier to disable channel. E.g. Platform disables supplier.

boolean
blacklisted
required

A way to blacklist a specific channel a property doesn’t want to send blocking to.

boolean
percentDiscount

Percent discount on this channel and all its children [unless configured at the child level].

number format: float
"" <= 1
commission

Amount of sales commission earned through this channel and all its children [unless configured at the child level].

number format: float
"" <= 1
rateModifiers

Promotions for this channel

Array<object>
""
object
identifier
required

Unique record identifier

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

Hotel identifier.

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

Internal name of promotion.

string
"" >= 1 characters
type
required

Set whether you want the price to go up or down when the rules of this promotion have been satisfied.

string
""
Allowed values: PREMIUM DISCOUNT
modifier
required
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

Whether this promotion is enabled or not.

boolean
default: true
pricingType
required

This determines whether this discount should be applied per night, per stay or per person - per night

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

Localized descriptions describing promotion. At least one English entry is required.

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
cityRateQualifiers

Restrict promotion to specific cities. See Geo-IP city geoname data

Array<object>
""
object
city
required

City geoIP

object
geoNameId
required

GeoNameLightweight identifiers taken from https://geonames.org.

string
"" >= 1 characters
localeCode
required

Locale code

string
"" >= 1 characters
continentCode
required

Continent code

string
"" >= 1 characters
continentName
required

Continent name

string
"" >= 1 characters
countryIsoCode
required

Country ISO code

string
"" >= 1 characters
countryName
required

Country name

string
"" >= 1 characters
cityName
required

City name

string
"" >= 1 characters
timezone
required

Timezone

string
"" >= 1 characters
subDivision1Code

Sub-division 1 code

string
""
subDivision1Name

Sub-division 1 name

string
""
subDivision2Code

Sub-division 2 code

string
""
subDivision2Name

Sub-division 2 name

string
""
continentRateQualifiers

Restrict promotion to specific continents. See Geo-IP continent geoname data

Array<object>
""
object
continent
required

Continent code

string
"" >= 1 characters
countryRateQualifiers

Restrict promotion to specific countries. See Geo-IP country geoname data

Array<object>
""
object
country
required

Country to restrict on

object
geoNameId
string
continentCode
string
continentName
string
countryIsoCode
string
countryName
string
promotionRateQualifiers

Restrict promotion by requiring users to enter a promo code.

Array<object>
""
object
promotion
required

Promotion code

string
"" >= 1 characters
ipRangeRateQualifiers

Restrict promotion to specific IP ranges.

Array<object>
""
object
startIPRange
required

Start of IP range

string
"" >= 1 characters
endIPRange
required

End of IP range

string
"" >= 1 characters
roomRangeRateQualifier

Restrict promotion by restricting to how many rooms the user wants.

object
minRooms
required

Minimum number of rooms

integer format: int32
"" >= 1
maxRooms

Maximum number of rooms

integer format: int32
""
prepayRateQualifier

Restrict promotion to either prepaid / non-prepaid rates.

object
prepay
required

Whether prepay is required or not

boolean
refundableRateQualifier

Restrict promotion to either refundable / non-refundable rates.

object
refundable
required

Whether restriction is on refundable rates

boolean
timezoneRateQualifiers

Restrict promotion to specific time zones. See Geo-IP timezone geoname data

Array<object>
""
object
timezone
required

Bookers timezone

string
"" >= 1 characters
lastMinuteRateQualifier

Restrict promotion to users who want to book a room close to the date.

object
seconds

Seconds before day of arrival occurs

integer format: int64
""
lengthOfStayRateQualifier

Restrict promotion to users who want to stay a certain number of days.

object
minLOS

Minimum length of stay qualifier

integer format: int32
""
maxLOS

Maximum length of stay qualifier

integer format: int32
""
advanceBookingRateQualifier

Restrict promotion to users who want to book in advance.

object
minAdvanceBookingOffset

Minimum advance booking offset qualifier

integer format: int32
""
maxAdvanceBookingOffset

Maximum advance booking offset qualifier

integer format: int32
""
stayDateRateQualifiers

Restrict promotion to specific stay dates the user wants to arrive.

Array<object>
""
object
effectiveDate
required

The effective (start) date of the stay date rate qualifier

string format: date
""
expireDate
required

The expiration (end) date of the stay date rate qualifier

string format: date
""
sellDateRateQualifiers

Restrict promotion to specific dates the booking is made.

Array<object>
""
object
effectiveDate
required

The effective (start) date of the sell date rate qualifier

string format: date
""
expireDate
required

The expiration (end) date of the sell date rate qualifier

string format: date
""
availableDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the promotion is available.

object
daysOfWeek
required

The days of the week when this rate is available

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
arrivalDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is arriving.

object
daysOfWeek
required

The days of the week when this rate is available for guests to arrive on

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
departureDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is departing.

object
daysOfWeek
required

The days of the week when this rate is available

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
requiredDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest has to stay.

object
daysOfWeek
required

The days of the week the user has to stay on to get this rate

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
masterRateIdentifiers

Restrict on specific master rates.

Array<string>
""
addOnIdentifiers

Restrict on specific add-ons.

Array<string>
""
ratePlanIdentifiers

Restrict on specific rate plans.

Array<string>
""
blackoutDates

Exclude this promotion from specific date ranges.

Array<object>
""
object
effectiveDate
required

Blackout start date.

string format: date
""
expireDate
required

Blackout end date.

string format: date
""
rateModifierBundles

Promotion bundles for this channel

Array<object>
""
object
identifier
required

Unique record identifier

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

Hotel identifier.

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

Internal name of promotion ancillary.

string
"" >= 1 characters
enabled
required

Whether this promotion ancillary is enabled or not.

boolean
default: true
items
required
Array<object>
>= 1 items

Promotions that go together to make up this ancillary.

object
identifier
required

Unique record identifier

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

Hotel identifier.

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

Internal name of promotion.

string
"" >= 1 characters
type
required

Set whether you want the price to go up or down when the rules of this promotion have been satisfied.

string
""
Allowed values: PREMIUM DISCOUNT
modifier
required
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

Whether this promotion is enabled or not.

boolean
default: true
pricingType
required

This determines whether this discount should be applied per night, per stay or per person - per night

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

Localized descriptions describing promotion. At least one English entry is required.

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
cityRateQualifiers

Restrict promotion to specific cities. See Geo-IP city geoname data

Array<object>
""
object
city
required

City geoIP

object
geoNameId
required

GeoNameLightweight identifiers taken from https://geonames.org.

string
"" >= 1 characters
localeCode
required

Locale code

string
"" >= 1 characters
continentCode
required

Continent code

string
"" >= 1 characters
continentName
required

Continent name

string
"" >= 1 characters
countryIsoCode
required

Country ISO code

string
"" >= 1 characters
countryName
required

Country name

string
"" >= 1 characters
cityName
required

City name

string
"" >= 1 characters
timezone
required

Timezone

string
"" >= 1 characters
subDivision1Code

Sub-division 1 code

string
""
subDivision1Name

Sub-division 1 name

string
""
subDivision2Code

Sub-division 2 code

string
""
subDivision2Name

Sub-division 2 name

string
""
continentRateQualifiers

Restrict promotion to specific continents. See Geo-IP continent geoname data

Array<object>
""
object
continent
required

Continent code

string
"" >= 1 characters
countryRateQualifiers

Restrict promotion to specific countries. See Geo-IP country geoname data

Array<object>
""
object
country
required

Country to restrict on

object
geoNameId
string
continentCode
string
continentName
string
countryIsoCode
string
countryName
string
promotionRateQualifiers

Restrict promotion by requiring users to enter a promo code.

Array<object>
""
object
promotion
required

Promotion code

string
"" >= 1 characters
ipRangeRateQualifiers

Restrict promotion to specific IP ranges.

Array<object>
""
object
startIPRange
required

Start of IP range

string
"" >= 1 characters
endIPRange
required

End of IP range

string
"" >= 1 characters
roomRangeRateQualifier

Restrict promotion by restricting to how many rooms the user wants.

object
minRooms
required

Minimum number of rooms

integer format: int32
"" >= 1
maxRooms

Maximum number of rooms

integer format: int32
""
prepayRateQualifier

Restrict promotion to either prepaid / non-prepaid rates.

object
prepay
required

Whether prepay is required or not

boolean
refundableRateQualifier

Restrict promotion to either refundable / non-refundable rates.

object
refundable
required

Whether restriction is on refundable rates

boolean
timezoneRateQualifiers

Restrict promotion to specific time zones. See Geo-IP timezone geoname data

Array<object>
""
object
timezone
required

Bookers timezone

string
"" >= 1 characters
lastMinuteRateQualifier

Restrict promotion to users who want to book a room close to the date.

object
seconds

Seconds before day of arrival occurs

integer format: int64
""
lengthOfStayRateQualifier

Restrict promotion to users who want to stay a certain number of days.

object
minLOS

Minimum length of stay qualifier

integer format: int32
""
maxLOS

Maximum length of stay qualifier

integer format: int32
""
advanceBookingRateQualifier

Restrict promotion to users who want to book in advance.

object
minAdvanceBookingOffset

Minimum advance booking offset qualifier

integer format: int32
""
maxAdvanceBookingOffset

Maximum advance booking offset qualifier

integer format: int32
""
stayDateRateQualifiers

Restrict promotion to specific stay dates the user wants to arrive.

Array<object>
""
object
effectiveDate
required

The effective (start) date of the stay date rate qualifier

string format: date
""
expireDate
required

The expiration (end) date of the stay date rate qualifier

string format: date
""
sellDateRateQualifiers

Restrict promotion to specific dates the booking is made.

Array<object>
""
object
effectiveDate
required

The effective (start) date of the sell date rate qualifier

string format: date
""
expireDate
required

The expiration (end) date of the sell date rate qualifier

string format: date
""
availableDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the promotion is available.

object
daysOfWeek
required

The days of the week when this rate is available

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
arrivalDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is arriving.

object
daysOfWeek
required

The days of the week when this rate is available for guests to arrive on

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
departureDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is departing.

object
daysOfWeek
required

The days of the week when this rate is available

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
requiredDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest has to stay.

object
daysOfWeek
required

The days of the week the user has to stay on to get this rate

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
masterRateIdentifiers

Restrict on specific master rates.

Array<string>
""
addOnIdentifiers

Restrict on specific add-ons.

Array<string>
""
ratePlanIdentifiers

Restrict on specific rate plans.

Array<string>
""
blackoutDates

Exclude this promotion from specific date ranges.

Array<object>
""
object
effectiveDate
required

Blackout start date.

string format: date
""
expireDate
required

Blackout end date.

string format: date
""
modifierOverride
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

Required if manual override modifier is not null

string
""
Allowed values: PREMIUM DISCOUNT
pricingType

Determines whether this discount should be applied per night, per stay or per person - per night; Required if amount override is not null

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
descriptions

Optional bundle-level descriptions. When populated, these replace the aggregated item descriptions in offerDetails.

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
isValid
boolean
aggregatedItemDescriptions
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
hasFixedDiscountModifier
boolean
hasPercentDiscountModifier
boolean
effectiveDescriptions
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
selfAcquires

Whether the sales channel is a self-acquiring entity.

boolean
inventoryType
required

Inventory type

string
""
Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY
inventoryIdentifier
required

Inventory type identifier

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

Name of inventory as hotel is seeing it

string
"" >= 1 characters
inventoryNameInEnglish
required

Name of inventory as traveler is seeing it

string
"" >= 1 characters
enabled
required

Whether this inventory is enabled or not

boolean
default: true
image
required

Main image of inventory

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
pricePoint
required

Level of expensiveness.

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

Location

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
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
""
quantity
required

Quantity

integer format: int32
0
commissionable
required

Whether this is commissionable or not

boolean
bookable
required

Whether inventory can be booked

boolean
default: true
continent
required

Which continent the inventory is located on

string
"" >= 1 characters
countryCode
required

Which country the inventory is located on

string
"" >= 1 characters
countryGeoNameId
required

Which country the inventory is located on

string
"" >= 1 characters
cityGeoNameId
required

Which city the inventory is located on

string
"" >= 1 characters
cityUrlName
required

Which city the inventory is located on

string
"" >= 1 characters
lowestPrice

Best price of the room type or facility ancillary

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

Best price of the room type or facility ancillary in platform currency

object
amount
required
number
currency
required
string
>= 1 characters
accessibleRatePlans
Array<object>
object
identifier
string
name
string
map
object
key
additional properties
string
reasons
Array<string>
inaccessibleRatePlans
Array<object>
object
identifier
string
name
string
map
object
key
additional properties
string
reasons
Array<string>
accessibleAvailability
Array<object>
object
room
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
transactionalInventoryList

Purchasable items for this blocking.

Array<object>

This is one 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
basePrice
required

Base price of booking this blocking.

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

If you are selling this blocking at a discount, indicate the discounted selling price. Leave empty if there is no discount.

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

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
percentDiscount

Calculates the percent difference between basePrice and discountedPrice.

number
""
percentPremium

Calculates the percent difference between basePrice and discountedPrice.

number
""
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
baseRate
required

Typical one night rate during regular remand period

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

Typical one night rate in a distressed period

object
amount
required
number
currency
required
string
>= 1 characters
available
boolean
bestPrice
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
promotionalCodes

Promotional codes

Array<string>
list
Array<object>
object
sourceBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
internalBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
sourceExtraPaxModifier
number
internalExtraPaxModifier
number
userSpecifiedCurrencyExtraPaxModifier
number
sourceExtraChildModifier
number
internalExtraChildModifier
number
userSpecifiedCurrencyExtraChildModifier
number
sourceSingleOccupantModifier
number
internalSingleOccupantModifier
number
userSpecifiedCurrencySingleOccupantModifier
number
sourcePromotionalModifier
number
internalPromotionalModifier
number
userSpecifiedCurrencyPromotionalModifier
number
sourcePremiumModifier
number
internalPremiumModifier
number
userSpecifiedCurrencyPremiumModifier
number
sourceChannelModifier
number
internalChannelModifier
number
userSpecifiedCurrencyChannelModifier
number
available
boolean
isStartDate
boolean
isEndDate
boolean
isBetweenDate
boolean
isLastNight
boolean
offerDetails
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
hasModification
boolean
isBundledModifier
boolean
hasChannelDiscount
boolean
channelDiscountPercent
number
promotionalDiscountPercent
number
premiumPercent
number
promotion
string
adults
integer format: int32
children
integer format: int32
rate
required
object
identifier
required

Unique record identifier.

string
"" >= 1 characters
hotelIdentifier
required

Owner of daily rate.

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

Indicate where this rate originated from. Leave as TRAVELIKO unless you are a channel manager and responsible for the property’s rates externally of this platform.

string
default: TRAVELIKO >= 1 characters
ratePlanIdentifier
required

Rate plan associated with this daily rate.

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

Guest room associated with this daily rate.

string format: uuid
"" >= 1 characters
rate
required
object
amount
required
number
currency
required
string
>= 1 characters
master
required

This flag indicates whether this rate is available for this date.

boolean
default: true
closedOnArrival
required

This flag indicates whether a guest can arrive at the property on this date.

boolean
closedOnDeparture
required

This flag indicates whether a guest can leave the property on this date.

boolean
date
required

The date this rate is applicable for.

string format: date
""
quantity

Amount of rooms available for this date.

integer format: int32
0
minOccupancy
required

Minimum number of guests allowed in a room type.

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

Maximum number of guest allowed in a room type.

integer format: int32
default: 2 >= 1
minLengthOfStay

Control the minimum length of stay at the day-level. This means that a guest arriving within this date range is required to stay at least these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
maxLengthOfStay

Control the maximum length of stay at the day-level. This means that a guest arriving within this date range is required to stay no longer than these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
singleOccupancyRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
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
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
sourceToUserCurrencyQuote
required
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
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
phantom
required
boolean
financialBreakdown
object
sourceCurrency
string
internalCurrency
string
displayCurrency
string
displayPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
internalPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
sourceAmount
number
internalAmount
number
displayAmount
number
sourceAmountRefundModifier
number
internalAmountRefundModifier
number
displayAmountRefundModifier
number
netSourceAmount
number
netInternalAmount
number
netDisplayAmount
number
commissionableTotalSourceAmount
number
commissionableTotalInternalAmount
number
commissionableTotalDisplayAmount
number
netCommissionableTotalSourceAmount
number
netCommissionableTotalInternalAmount
number
netCommissionableTotalDisplayAmount
number
totalFeesAndCommissionsSourceAmount
number
totalFeesAndCommissionsInternalAmount
number
totalFeesAndCommissionsDisplayAmount
number
netTotalFeesAndCommissionsSourceAmount
number
netTotalFeesAndCommissionsInternalAmount
number
netTotalFeesAndCommissionsDisplayAmount
number
totalFeesSourceAmount
number
totalFeesInternalAmount
number
totalFeesDisplayAmount
number
netTotalFeesSourceAmount
number
netTotalFeesInternalAmount
number
netTotalFeesDisplayAmount
number
totalTripPayFeeSourceAmount
number
totalTripPayFeeInternalAmount
number
totalTripPayFeeDisplayAmount
number
netTotalTripPayFeeSourceAmount
number
netTotalTripPayFeeInternalAmount
number
netTotalTripPayFeeDisplayAmount
number
totalSalesSourceAmount
number
totalSalesInternalAmount
number
totalSalesDisplayAmount
number
netTotalSalesSourceAmount
number
netTotalSalesInternalAmount
number
netTotalSalesDisplayAmount
number
totalAffiliateAgencyFeesSourceAmount
number
totalAffiliateAgencyFeesInternalAmount
number
totalAffiliateAgencyFeesDisplayAmount
number
netTotalAffiliateAgencyFeesSourceAmount
number
netTotalAffiliateAgencyFeesInternalAmount
number
netTotalAffiliateAgencyFeesDisplayAmount
number
totalSupplierAgencyFeesSourceAmount
number
totalSupplierAgencyFeesInternalAmount
number
totalSupplierAgencyFeesDisplayAmount
number
netTotalSupplierAgencyFeesSourceAmount
number
netTotalSupplierAgencyFeesInternalAmount
number
netTotalSupplierAgencyFeesDisplayAmount
number
netTotalCustomersSourceAmount
number
netTotalCustomersInternalAmount
number
netTotalCustomersDisplayAmount
number
metadata
object
key
additional properties
sourceTotal

Final per-night rate in hotel currency (base + modifiers). Computed at instantiation.

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

Final per-night rate in wink currency (base + modifiers). Computed at instantiation.

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

Final per-night rate in user specified currency (base + modifiers). Computed at instantiation.

object
amount
required
number
currency
required
string
>= 1 characters
date
string format: date
endDate
boolean
sourceRate
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyRate
object
amount
required
number
currency
required
string
>= 1 characters
internalRate
object
amount
required
number
currency
required
string
>= 1 characters
baseRate
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
startDate
boolean
betweenDate
boolean
lastNight
boolean
bundledModifier
boolean
closeOnDeparture
boolean
inventoryAvailable
boolean
masterAvailability
boolean
closeOnArrival
boolean
rateIdentifier
string
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
source
string
maxOccupancy
integer format: int32
minOccupancy
integer format: int32
minLOS
integer format: int32
maxLOS
integer format: int32
quantity
integer format: int32
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
financialBreakdown
object
sourceCurrency
string
internalCurrency
string
displayCurrency
string
displayPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
internalPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
sourceAmount
number
internalAmount
number
displayAmount
number
sourceAmountRefundModifier
number
internalAmountRefundModifier
number
displayAmountRefundModifier
number
netSourceAmount
number
netInternalAmount
number
netDisplayAmount
number
commissionableTotalSourceAmount
number
commissionableTotalInternalAmount
number
commissionableTotalDisplayAmount
number
netCommissionableTotalSourceAmount
number
netCommissionableTotalInternalAmount
number
netCommissionableTotalDisplayAmount
number
totalFeesAndCommissionsSourceAmount
number
totalFeesAndCommissionsInternalAmount
number
totalFeesAndCommissionsDisplayAmount
number
netTotalFeesAndCommissionsSourceAmount
number
netTotalFeesAndCommissionsInternalAmount
number
netTotalFeesAndCommissionsDisplayAmount
number
totalFeesSourceAmount
number
totalFeesInternalAmount
number
totalFeesDisplayAmount
number
netTotalFeesSourceAmount
number
netTotalFeesInternalAmount
number
netTotalFeesDisplayAmount
number
totalTripPayFeeSourceAmount
number
totalTripPayFeeInternalAmount
number
totalTripPayFeeDisplayAmount
number
netTotalTripPayFeeSourceAmount
number
netTotalTripPayFeeInternalAmount
number
netTotalTripPayFeeDisplayAmount
number
totalSalesSourceAmount
number
totalSalesInternalAmount
number
totalSalesDisplayAmount
number
netTotalSalesSourceAmount
number
netTotalSalesInternalAmount
number
netTotalSalesDisplayAmount
number
totalAffiliateAgencyFeesSourceAmount
number
totalAffiliateAgencyFeesInternalAmount
number
totalAffiliateAgencyFeesDisplayAmount
number
netTotalAffiliateAgencyFeesSourceAmount
number
netTotalAffiliateAgencyFeesInternalAmount
number
netTotalAffiliateAgencyFeesDisplayAmount
number
totalSupplierAgencyFeesSourceAmount
number
totalSupplierAgencyFeesInternalAmount
number
totalSupplierAgencyFeesDisplayAmount
number
netTotalSupplierAgencyFeesSourceAmount
number
netTotalSupplierAgencyFeesInternalAmount
number
netTotalSupplierAgencyFeesDisplayAmount
number
netTotalCustomersSourceAmount
number
netTotalCustomersInternalAmount
number
netTotalCustomersDisplayAmount
number
metadata
object
key
additional properties
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
transactionalInventoryList

Purchasable items for this blocking.

Array<object>

This is one 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
basePrice
required

Base price of booking this blocking.

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

If you are selling this blocking at a discount, indicate the discounted selling price. Leave empty if there is no discount.

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

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
percentDiscount

Calculates the percent difference between basePrice and discountedPrice.

number
""
percentPremium

Calculates the percent difference between basePrice and discountedPrice.

number
""
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
priceConfigurations
Array<object>
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
promotionalCodes

Promotional codes

Array<string>
list
Array<object>
object
sourceBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
internalBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyBaseRate
object
amount
required
number
currency
required
string
>= 1 characters
sourceExtraPaxModifier
number
internalExtraPaxModifier
number
userSpecifiedCurrencyExtraPaxModifier
number
sourceExtraChildModifier
number
internalExtraChildModifier
number
userSpecifiedCurrencyExtraChildModifier
number
sourceSingleOccupantModifier
number
internalSingleOccupantModifier
number
userSpecifiedCurrencySingleOccupantModifier
number
sourcePromotionalModifier
number
internalPromotionalModifier
number
userSpecifiedCurrencyPromotionalModifier
number
sourcePremiumModifier
number
internalPremiumModifier
number
userSpecifiedCurrencyPremiumModifier
number
sourceChannelModifier
number
internalChannelModifier
number
userSpecifiedCurrencyChannelModifier
number
available
boolean
isStartDate
boolean
isEndDate
boolean
isBetweenDate
boolean
isLastNight
boolean
offerDetails
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
hasModification
boolean
isBundledModifier
boolean
hasChannelDiscount
boolean
channelDiscountPercent
number
promotionalDiscountPercent
number
premiumPercent
number
promotion
string
adults
integer format: int32
children
integer format: int32
rate
required
object
identifier
required

Unique record identifier.

string
"" >= 1 characters
hotelIdentifier
required

Owner of daily rate.

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

Indicate where this rate originated from. Leave as TRAVELIKO unless you are a channel manager and responsible for the property’s rates externally of this platform.

string
default: TRAVELIKO >= 1 characters
ratePlanIdentifier
required

Rate plan associated with this daily rate.

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

Guest room associated with this daily rate.

string format: uuid
"" >= 1 characters
rate
required
object
amount
required
number
currency
required
string
>= 1 characters
master
required

This flag indicates whether this rate is available for this date.

boolean
default: true
closedOnArrival
required

This flag indicates whether a guest can arrive at the property on this date.

boolean
closedOnDeparture
required

This flag indicates whether a guest can leave the property on this date.

boolean
date
required

The date this rate is applicable for.

string format: date
""
quantity

Amount of rooms available for this date.

integer format: int32
0
minOccupancy
required

Minimum number of guests allowed in a room type.

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

Maximum number of guest allowed in a room type.

integer format: int32
default: 2 >= 1
minLengthOfStay

Control the minimum length of stay at the day-level. This means that a guest arriving within this date range is required to stay at least these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
maxLengthOfStay

Control the maximum length of stay at the day-level. This means that a guest arriving within this date range is required to stay no longer than these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
singleOccupancyRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

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

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
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
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
sourceToUserCurrencyQuote
required
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
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
phantom
required
boolean
financialBreakdown
object
sourceCurrency
string
internalCurrency
string
displayCurrency
string
displayPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
internalPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
sourceAmount
number
internalAmount
number
displayAmount
number
sourceAmountRefundModifier
number
internalAmountRefundModifier
number
displayAmountRefundModifier
number
netSourceAmount
number
netInternalAmount
number
netDisplayAmount
number
commissionableTotalSourceAmount
number
commissionableTotalInternalAmount
number
commissionableTotalDisplayAmount
number
netCommissionableTotalSourceAmount
number
netCommissionableTotalInternalAmount
number
netCommissionableTotalDisplayAmount
number
totalFeesAndCommissionsSourceAmount
number
totalFeesAndCommissionsInternalAmount
number
totalFeesAndCommissionsDisplayAmount
number
netTotalFeesAndCommissionsSourceAmount
number
netTotalFeesAndCommissionsInternalAmount
number
netTotalFeesAndCommissionsDisplayAmount
number
totalFeesSourceAmount
number
totalFeesInternalAmount
number
totalFeesDisplayAmount
number
netTotalFeesSourceAmount
number
netTotalFeesInternalAmount
number
netTotalFeesDisplayAmount
number
totalTripPayFeeSourceAmount
number
totalTripPayFeeInternalAmount
number
totalTripPayFeeDisplayAmount
number
netTotalTripPayFeeSourceAmount
number
netTotalTripPayFeeInternalAmount
number
netTotalTripPayFeeDisplayAmount
number
totalSalesSourceAmount
number
totalSalesInternalAmount
number
totalSalesDisplayAmount
number
netTotalSalesSourceAmount
number
netTotalSalesInternalAmount
number
netTotalSalesDisplayAmount
number
totalAffiliateAgencyFeesSourceAmount
number
totalAffiliateAgencyFeesInternalAmount
number
totalAffiliateAgencyFeesDisplayAmount
number
netTotalAffiliateAgencyFeesSourceAmount
number
netTotalAffiliateAgencyFeesInternalAmount
number
netTotalAffiliateAgencyFeesDisplayAmount
number
totalSupplierAgencyFeesSourceAmount
number
totalSupplierAgencyFeesInternalAmount
number
totalSupplierAgencyFeesDisplayAmount
number
netTotalSupplierAgencyFeesSourceAmount
number
netTotalSupplierAgencyFeesInternalAmount
number
netTotalSupplierAgencyFeesDisplayAmount
number
netTotalCustomersSourceAmount
number
netTotalCustomersInternalAmount
number
netTotalCustomersDisplayAmount
number
metadata
object
key
additional properties
sourceTotal

Final per-night rate in hotel currency (base + modifiers). Computed at instantiation.

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

Final per-night rate in wink currency (base + modifiers). Computed at instantiation.

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

Final per-night rate in user specified currency (base + modifiers). Computed at instantiation.

object
amount
required
number
currency
required
string
>= 1 characters
date
string format: date
endDate
boolean
sourceRate
object
amount
required
number
currency
required
string
>= 1 characters
userSpecifiedCurrencyRate
object
amount
required
number
currency
required
string
>= 1 characters
internalRate
object
amount
required
number
currency
required
string
>= 1 characters
baseRate
object
amount
required
number
currency
required
string
>= 1 characters
totalDiscountPercent
number
startDate
boolean
betweenDate
boolean
lastNight
boolean
bundledModifier
boolean
closeOnDeparture
boolean
inventoryAvailable
boolean
masterAvailability
boolean
closeOnArrival
boolean
rateIdentifier
string
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
source
string
maxOccupancy
integer format: int32
minOccupancy
integer format: int32
minLOS
integer format: int32
maxLOS
integer format: int32
quantity
integer format: int32
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
financialBreakdown
object
sourceCurrency
string
internalCurrency
string
displayCurrency
string
displayPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
internalPriceQuote
object
source
required

Source

string
"" >= 1 characters
target
required

Target

string
"" >= 1 characters
exchangeRate
required

Exchange rate

number
""
timestamp
required

Timestamp

integer format: int64
""
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
sourceAmount
number
internalAmount
number
displayAmount
number
sourceAmountRefundModifier
number
internalAmountRefundModifier
number
displayAmountRefundModifier
number
netSourceAmount
number
netInternalAmount
number
netDisplayAmount
number
commissionableTotalSourceAmount
number
commissionableTotalInternalAmount
number
commissionableTotalDisplayAmount
number
netCommissionableTotalSourceAmount
number
netCommissionableTotalInternalAmount
number
netCommissionableTotalDisplayAmount
number
totalFeesAndCommissionsSourceAmount
number
totalFeesAndCommissionsInternalAmount
number
totalFeesAndCommissionsDisplayAmount
number
netTotalFeesAndCommissionsSourceAmount
number
netTotalFeesAndCommissionsInternalAmount
number
netTotalFeesAndCommissionsDisplayAmount
number
totalFeesSourceAmount
number
totalFeesInternalAmount
number
totalFeesDisplayAmount
number
netTotalFeesSourceAmount
number
netTotalFeesInternalAmount
number
netTotalFeesDisplayAmount
number
totalTripPayFeeSourceAmount
number
totalTripPayFeeInternalAmount
number
totalTripPayFeeDisplayAmount
number
netTotalTripPayFeeSourceAmount
number
netTotalTripPayFeeInternalAmount
number
netTotalTripPayFeeDisplayAmount
number
totalSalesSourceAmount
number
totalSalesInternalAmount
number
totalSalesDisplayAmount
number
netTotalSalesSourceAmount
number
netTotalSalesInternalAmount
number
netTotalSalesDisplayAmount
number
totalAffiliateAgencyFeesSourceAmount
number
totalAffiliateAgencyFeesInternalAmount
number
totalAffiliateAgencyFeesDisplayAmount
number
netTotalAffiliateAgencyFeesSourceAmount
number
netTotalAffiliateAgencyFeesInternalAmount
number
netTotalAffiliateAgencyFeesDisplayAmount
number
totalSupplierAgencyFeesSourceAmount
number
totalSupplierAgencyFeesInternalAmount
number
totalSupplierAgencyFeesDisplayAmount
number
netTotalSupplierAgencyFeesSourceAmount
number
netTotalSupplierAgencyFeesInternalAmount
number
netTotalSupplierAgencyFeesDisplayAmount
number
netTotalCustomersSourceAmount
number
netTotalCustomersInternalAmount
number
netTotalCustomersDisplayAmount
number
metadata
object
key
additional properties
totalDiscountPercent
number
internalAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
sourceAveragePricePerNight
object
amount
required
number
currency
required
string
>= 1 characters
beneficiaryList
Array<object>

Beneficiary is a registered account with rights to compensation within a booking.

object
accountIdentifier
required

AccountIdentifier of beneficiary that can map to an account with us

string
"" >= 1 characters
accountName
required

AccountName of beneficiary that can map to an account with us

string
"" >= 1 characters
accountEmail
required

AccountEmail of beneficiary that can map to an account with us

string format: email
"" >= 1 characters
accountUrl

AccountUrl of beneficiary that can map to an account with us

string
""
type
required

The type of beneficiary payment.

string
""
Allowed values: TRIP_PAY PLATFORM_FEE COMMISSION AFFILIATE_AGENCY_FEE SUPPLIER_AGENCY_FEE SALE
amountDue

The original slice requested

object
type
required

The type of charge

string
""
Allowed values: PERCENTAGE REMAINDER
percent

A percentage of the total stay amount for an early checkin or late checkout

number
""
sourceCurrency
required

The source currency

string
"" >= 1 characters
displayCurrency
required

The display currency

string
"" >= 1 characters
internalCurrency
required

The internal currency

string
"" >= 1 characters
sourceAmount
required

Amount in source currency

number
""
displayAmount
required

Amount in display currency

number
""
internalAmount
required

Amount in internal currency

number
""
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
pendingRefunds
Array<object>

When a refund is first requested, it ends up here. Once it is applied, it moves out of this list and into the parent modifier property

object
refundIdentifier
required

This is the refund identifier located on the root bookingContract.refunds object

string
"" >= 1 characters
sourceAmountRefundModifier
required

The delta from the original source amount after a refund occurred

number
""
displayAmountRefundModifier
required

The delta from the original display amount after a refund occurred

number
""
internalAmountRefundModifier
required

The delta from the original internal amount after a refund occurred

number
""
netSourceAmount
required

Source amount minus source modifier.

number
""
netDisplayAmount
required

Display amount minus display modifier.

number
""
netInternalAmount
required

Internal amount minus internal modifier.

number
""
reconciled

Whether a funds transfer has occurred for this booking.

boolean
metadata

Place to add more data related to the beneficiary.

object
key
additional properties
string
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
transactionalInventoryList

Purchasable items for this blocking.

Array<object>

This is one 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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
basePrice
required

Base price of booking this blocking.

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

If you are selling this blocking at a discount, indicate the discounted selling price. Leave empty if there is no discount.

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

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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
""
percentDiscount

Calculates the percent difference between basePrice and discountedPrice.

number
""
percentPremium

Calculates the percent difference between basePrice and discountedPrice.

number
""
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
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
inaccessibleAvailabilityReason
object
identifier
string
name
string
map
object
key
additional properties
string
reasons
Array<string>
inaccessibleAvailability
Array<object>
object
identifier
string
name
string
map
object
key
additional properties
string
reasons
Array<string>
Example
[
{
"accessibleMasterRates": [
null
],
"accessibleInventory": [
{
"id": "",
"createdDate": "",
"lastUpdate": "",
"version": "",
"salesChannel": "",
"inventoryType": "GUEST_ROOM",
"inventoryIdentifier": "",
"inventoryName": "",
"inventoryNameInEnglish": "",
"enabled": true,
"image": "",
"pricePoint": "HALF",
"location": "",
"address": "",
"quantity": 0,
"commissionable": false,
"bookable": true,
"continent": "",
"countryCode": "",
"countryGeoNameId": "",
"cityGeoNameId": "",
"cityUrlName": "",
"lowestPrice": "",
"lowestDisplayPrice": ""
}
],
"accessibleAvailability": [
{
"room": {
"identifier": "",
"hotelIdentifier": "",
"featuredInd": false,
"lifestyleType": "LIFESTYLE_HEALTH_FITNESS",
"location": "",
"descriptions": [
""
],
"multimedias": [
""
],
"contact": "",
"address": "",
"commissionable": true,
"name": "",
"proximityCode": "",
"sort": "",
"minAgeAppropriateCode": "",
"bookable": true,
"active": true,
"disabilityFeatures": [
""
],
"securityFeatures": [
""
],
"socials": [
""
],
"pricePoint": "HALF",
"recognitionList": [
""
],
"transactionalInventoryList": [
""
],
"maxOccupancy": 2,
"minOccupancy": 1,
"quantity": "",
"nonSmoking": false,
"bedroomConfigurationList": [
""
],
"size": "",
"maxAdultOccupancy": 2,
"maxChildOccupancy": 0,
"bathroomCount": 1,
"livingRoomCount": 1,
"maxRollaways": 0,
"roomCategory": "",
"floor": "",
"roomLocationCode": "",
"roomViewCode": "",
"composite": false,
"compositeCount": 0,
"roomClassificationCode": "",
"roomArchitectureCode": "",
"roomGender": "Male",
"sharedRoomInd": false,
"maxCribs": 0,
"amenities": [
""
],
"includedAdultOccupancy": 2,
"includedChildOccupancy": 0,
"baseRate": "",
"minRate": ""
},
"bestPrice": {
"channelInventoryIdentifier": "",
"list": [
null
],
"commissionable": false,
"commission": "",
"direct": false,
"adults": "",
"children": "",
"startDate": "",
"endDate": "",
"roomRateIdentifier": "",
"roomRateInternalName": "",
"ratePlan": "",
"perkTypes": [
""
],
"price": "",
"extraCharges": "",
"configuration": "",
"addOnOffers": [
""
],
"perkValue": "",
"activeCancellationPolicy": "",
"roomNights": "",
"priceList": [
null
]
},
"priceConfigurations": [
{
"channelInventoryIdentifier": "",
"list": [
null
],
"commissionable": false,
"commission": "",
"direct": false,
"adults": "",
"children": "",
"startDate": "",
"endDate": "",
"roomRateIdentifier": "",
"roomRateInternalName": "",
"ratePlan": "",
"perkTypes": [
""
],
"price": "",
"extraCharges": "",
"configuration": "",
"addOnOffers": [
""
],
"perkValue": "",
"activeCancellationPolicy": "",
"roomNights": "",
"priceList": [
null
]
}
]
}
]
}
]

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