Skip to content

Update rates via keyed list

PUT
/api/managing-entity/{managingEntityIdentifier}/extranet/rate/update
curl --request PUT \
--url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/rate/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data '[ null ]'

Apply per-day rate and availability changes using an explicit list of keyed daily rate updates. Each update identifies a specific date and master rate, then applies custom changes for that day. This endpoint supports updates to deltaQuantity with idempotency keys to safely adjust inventory over time.

managingEntityIdentifier
required
string
""

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

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
Wink-Version
string
default: 2.0.0
Allowed values: 2.0
Media type application/json
Array<object>

Wrapper pairing a rate key with update values for a single daily rate

object
key
required

Rate identification key (hotel, rate plan, room, date)

object
hotelIdentifier
required

Property identifier that owns this rate

string format: uuid
""
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
ratePlanIdentifier
required

Rate plan identifier for pricing and restrictions

string format: uuid
""
Example
7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52
guestRoomIdentifier
required

Guest room (room type) identifier for this rate

string format: uuid
""
Example
6f9b4c8d-1e5a-4b3c-9d2e-8a7f0c1b5e43
date
required

Date this rate applies to

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

Rate update values for this key

object
quantity

Absolute number of available rooms for this date. Set this OR deltaQuantity, not both.

integer format: int32
""
Example
5
deltaQuantity

Relative change to room availability (add/subtract). Use with idempotencyKey to prevent duplicate adjustments.

integer format: int32
""
Example
1
idempotencyKey

Idempotency key to prevent duplicate inventory adjustments when using deltaQuantity (e.g., ‘booking123:CREATED’)

string
""
Example
booking-f4d1c8e5-2b9a:CREATED
master

Whether this rate is available for booking on this date

boolean
default: true
Example
true
closedOnArrival

Whether the property is closed on arrival for this date

boolean
Example
false
closedOnDeparture

Whether the property is closed on departure for this date

boolean
Example
false
minLengthOfStay

Minimum length of stay required for arrivals on this date, in days. -1 means no minimum.

integer format: int32
""
Example
2
maxLengthOfStay

Maximum length of stay allowed for arrivals on this date, in days. -1 means no maximum.

integer format: int32
""
Example
30
rate

Nightly rate amount (base rate)

number
""
Example
450
currencyCode

ISO 4217 currency code for this rate

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

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
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
""
Example
0.25
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters

Successfully updated daily rates. 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
]

Invalid update list (empty list, missing required keys/values, invalid rate data)

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

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

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

Internal Server Error

object
Example generated
{}