Bulk update rates for date range
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/master-rate/5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73/rate/bulk';const options = { method: 'PUT', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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 nullApply 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”Property identifier (managing entity UUID) owning the rates to update
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Master rate identifier (room type + rate plan) to bulk update
Example
5e8a3b7c-0d4f-4a2b-8c1d-9e6f2a0b4c73Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Uniform rate and availability changes to apply across all days in the specified date range for this master rate
Bulk rate update request to apply consistent changes to a date range for one master rate
object
Whether guests cannot check in during this date range (Closed on Arrival)
Example
falseWhether guests cannot check out during this date range (Closed on Departure)
Example
falseEnd date (inclusive) for the bulk rate update
Example
2026-01-31Rate modifier for extra child guests during this date range
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
Example
1250ISO 4217 currency code
Example
USDExample
{ "amount": 1250, "currency": "USD"}A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
Example
0.25When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Example
PERCENTAGEExample
{ "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE"}Rate modifier for extra adult guests during this date range
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
Example
1250ISO 4217 currency code
Example
USDExample
{ "amount": 1250, "currency": "USD"}A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
Example
0.25When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Example
PERCENTAGEExample
{ "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE"}Whether the rate is available for booking during this date range
Example
trueMaximum length of stay (in days) allowed for arrivals within this date range. Omit to keep current maximum unchanged.
Example
30Minimum length of stay (in days) required for arrivals within this date range. Omit to keep current minimum unchanged.
Example
2Number of available rooms for each day in this date range. Omit to keep current inventory unchanged.
Example
8Nightly rate amount for this date range. Omit to keep current rate unchanged.
object
Monetary amount value
Example
1250ISO 4217 currency code
Example
USDExample
{ "amount": 1250, "currency": "USD"}Source of the rate update. Use NONE for property-managed rates, or specify channel manager identifier
Example
NONERate modifier for single occupancy bookings during this date range
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
Example
1250ISO 4217 currency code
Example
USDExample
{ "amount": 1250, "currency": "USD"}A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
Example
0.25When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Example
PERCENTAGEExample
{ "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE"}Start date (inclusive) for the bulk rate update
Example
2026-01-14Example
{ "closedOnArrival": false, "closedOnDeparture": false, "endDate": "2026-01-31", "extraChildRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "extraPaxRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "master": true, "maxLengthOfStay": 30, "minLengthOfStay": 2, "numberOfUnits": 8, "rate": { "amount": 1250, "currency": "USD" }, "rateSource": "NONE", "singleOccupancyRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "startDate": "2026-01-14"}Responses
Section titled “Responses”All daily rates in the date range updated uniformly; returns the updated Rate documents
Lightweight projection of a single rate date, used by consumers outside the rate module.
object
Whether guests cannot check in on this date (Closed on Arrival)
Whether guests cannot check out on this date (Closed on Departure)
ISO 4217 currency code for this rate
Day of the month (1-31)
Rate modifier (fixed amount or percentage) for extra child guests
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
ISO 4217 currency code
A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Rate modifier (fixed amount or percentage) for extra adult guests
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
ISO 4217 currency code
A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Guest room (room type) identifier for this rate
Property identifier that owns this daily rate
Unique document identifier (UUID)
Whether this rate is available for booking on this date
Maximum length of stay (in days) allowed for guests arriving on this date. -1 means no maximum.
Minimum length of stay (in days) required for guests arriving on this date. -1 means no minimum.
Month of the year (1-12)
Number of available rooms for this date
Nightly rate amount in the specified currency
Rate plan identifier for pricing controls and restrictions
Source of the rate update. NONE indicates property-managed rates; other values indicate channel manager origins.
Rate modifier (fixed amount or percentage) for single occupancy bookings
object
A localized amount, always non-negative. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
object
Monetary amount value
ISO 4217 currency code
A fraction between 0 and 1 (inclusive) representing a percentage of the total stay amount for an early check-in or late check-out, e.g. 0.25 for 25%. Direction (surcharge vs. discount) is determined by which field this charge is assigned to, not the sign of this value.
When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.
Year in ISO format
Example
[ { "closedOnArrival": false, "closedOnDeparture": false, "currencyCode": "THB", "day": 14, "extraChildRateModifier": { "percent": 0.15, "type": "PERCENTAGE" }, "extraPaxRateModifier": { "percent": 0.25, "type": "PERCENTAGE" }, "guestRoomIdentifier": "4b7e2c9a-6f1d-4a0b-8c3e-5d2f9b1a7c84", "hotelIdentifier": "7d4f2a1b-3e8c-4b0d-a5f9-1c2e6b4d8f07", "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "master": true, "maxLengthOfStay": 30, "minLengthOfStay": 2, "month": 1, "quantity": 9, "rate": 4500, "ratePlanIdentifier": "9a2d5e8c-1f4b-4c7a-b3e6-2d0f8a5c3e91", "rateSource": "NONE", "singleOccupancyRateModifier": { "percent": 0.8, "type": "PERCENTAGE" }, "year": 2026 }]Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable