Skip to content
Wink

Bulk update rates for date range

PUT
/api/managing-entity/{managingEntityIdentifier}/extranet/master-rate/{masterRateIdentifier}/rate/bulk
 
curl --request PUT \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/master-rate/5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73/rate/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data null

Apply uniform rate and availability changes across all days in a date range for a single master rate. Use this to quickly update nightly rate, availability limits, and occupancy restrictions across multiple dates.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Property identifier (managing entity UUID) owning the rates to update

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

Master rate identifier (room type + rate plan) to bulk update

Example 
5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73

Header Parameters

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

Request Body required

Section titled “Request Body required ”
Media type application/json

Bulk rate update request to apply consistent changes to a date range for one master rate

object
startDate
required

Start date (inclusive) for the bulk rate update

string format: date
""
Example 
2026-01-14
endDate
required

End date (inclusive) for the bulk rate update

string format: date
""
Example 
2026-01-31
rateSource
required

Source of the rate update. Use TRAVELIKO for property-managed rates, or specify channel manager identifier

string
default: TRAVELIKO
Example 
TRAVELIKO
master
required

Whether the rate is available for booking during this date range

boolean
default: true
Example 
true
closedOnArrival
required

Whether guests cannot check in during this date range (Closed on Arrival)

boolean
Example 
false
closedOnDeparture
required

Whether guests cannot check out during this date range (Closed on Departure)

boolean
Example 
false
numberOfUnits

Number of available rooms for each day in this date range. Omit to keep current inventory unchanged.

integer format: int32
""
Example 
8
rate

Nightly rate amount for this date range. Omit to keep current rate unchanged.

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

Minimum length of stay (in days) required for arrivals within this date range. Omit to keep current minimum unchanged.

integer format: int32
""
Example 
2
maxLengthOfStay

Maximum length of stay (in days) allowed for arrivals within this date range. Omit to keep current maximum unchanged.

integer format: int32
""
Example 
30
singleOccupancyRateModifier

Rate modifier for single occupancy bookings during this date range

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
""
Example 
0.25
fixedAmount

A localized amount

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

Rate modifier for extra adult guests during this date range

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
""
Example 
0.25
fixedAmount

A localized amount

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

Rate modifier for extra child guests during this date range

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
""
Example 
0.25
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successfully updated all daily rates for the date range. Returns list of updated Rate documents.

Media type application/json
Array<object>

Holds all the information for one rate date

object
id

Unique document identifier (UUID)

string format: uuid
""
hotelIdentifier
required

Property identifier that owns this daily rate

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

Source of the rate update. TRAVELIKO indicates property-managed rates; other values indicate channel manager origins.

string
default: TRAVELIKO >= 1 characters
ratePlanIdentifier
required

Rate plan identifier for pricing controls and restrictions

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

Guest room (room type) identifier for this rate

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

Nightly rate amount in the specified currency

number
""
currencyCode
required

ISO 4217 currency code for this rate

string
"" >= 1 characters
master
required

Whether this rate is available for booking on this date

boolean
default: true
closedOnArrival
required

Whether guests cannot check in on this date (Closed on Arrival)

boolean
closedOnDeparture
required

Whether guests cannot check out on this date (Closed on Departure)

boolean
day

Day of the month (1-31)

integer format: int32
""
month

Month of the year (1-12)

integer format: int32
""
year

Year in ISO format

integer format: int32
""
quantity

Number of available rooms for this date

integer format: int32
0
minLengthOfStay

Minimum length of stay (in days) required for guests arriving on this date. -1 means no minimum.

integer format: int32
default: -1
maxLengthOfStay

Maximum length of stay (in days) allowed for guests arriving on this date. -1 means no maximum.

integer format: int32
default: -1
singleOccupancyRateModifier

Rate modifier (fixed amount or percentage) for single occupancy bookings

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

Rate modifier (fixed amount or percentage) for extra adult guests

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

Rate modifier (fixed amount or percentage) for extra child guests

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

Time-to-live (TTL) for this rate record in MongoDB. Records are automatically removed 24 hours after this instant.

string format: date-time
""
available
boolean
Example 
[
  null
]

400

Section titled “400 ”

Invalid bulk request (invalid date range, missing required fields, invalid rate source)

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

401

Section titled “401 ”

Authentication required

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

403

Section titled “403 ”

Insufficient permissions (INVENTORY:WRITE required)

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

404

Section titled “404 ”

Property or master rate not found

Media type application/json
Array<object>

Holds all the information for one rate date

object
id

Unique document identifier (UUID)

string format: uuid
""
hotelIdentifier
required

Property identifier that owns this daily rate

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

Source of the rate update. TRAVELIKO indicates property-managed rates; other values indicate channel manager origins.

string
default: TRAVELIKO >= 1 characters
ratePlanIdentifier
required

Rate plan identifier for pricing controls and restrictions

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

Guest room (room type) identifier for this rate

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

Nightly rate amount in the specified currency

number
""
currencyCode
required

ISO 4217 currency code for this rate

string
"" >= 1 characters
master
required

Whether this rate is available for booking on this date

boolean
default: true
closedOnArrival
required

Whether guests cannot check in on this date (Closed on Arrival)

boolean
closedOnDeparture
required

Whether guests cannot check out on this date (Closed on Departure)

boolean
day

Day of the month (1-31)

integer format: int32
""
month

Month of the year (1-12)

integer format: int32
""
year

Year in ISO format

integer format: int32
""
quantity

Number of available rooms for this date

integer format: int32
0
minLengthOfStay

Minimum length of stay (in days) required for guests arriving on this date. -1 means no minimum.

integer format: int32
default: -1
maxLengthOfStay

Maximum length of stay (in days) allowed for guests arriving on this date. -1 means no maximum.

integer format: int32
default: -1
singleOccupancyRateModifier

Rate modifier (fixed amount or percentage) for single occupancy bookings

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

Rate modifier (fixed amount or percentage) for extra adult guests

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

Rate modifier (fixed amount or percentage) for extra child guests

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

Time-to-live (TTL) for this rate record in MongoDB. Records are automatically removed 24 hours after this instant.

string format: date-time
""
available
boolean
Example 
[
  null
]

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}