Update rates via keyed list
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/rate/update';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/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.
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-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Keyed list of per-day rate updates, each identifying a specific date and master rate with custom nightly rate, availability, and occupancy changes
Wrapper pairing a rate key with update values for a single daily rate
object
Rate identification key (hotel, rate plan, room, date)
object
Date this rate applies to
Example
2026-01-14Guest room (room type) identifier for this rate
Example
6f9b4c8d-1e5a-4b3c-9d2e-8a7f0c1b5e43Property identifier that owns this rate
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Rate plan identifier for pricing and restrictions
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Example
{ "date": "2026-01-14", "guestRoomIdentifier": "6f9b4c8d-1e5a-4b3c-9d2e-8a7f0c1b5e43", "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "ratePlanIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51"}Rate update values for this key
object
Whether the property is closed on arrival for this date
Example
falseWhether the property is closed on departure for this date
Example
falseISO 4217 currency code for this rate
Example
THBRelative change to room availability (add/subtract). Use with idempotencyKey to prevent duplicate adjustments.
Example
1Rate 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
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 (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
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"}Idempotency key to prevent duplicate inventory adjustments when using deltaQuantity (e.g., ‘booking123:CREATED’)
Example
booking-f4d1c8e5-2b9a:CREATEDWhether this rate is available for booking on this date
Example
trueMaximum length of stay allowed for arrivals on this date, in days. -1 means no maximum.
Example
30Minimum length of stay required for arrivals on this date, in days. -1 means no minimum.
Example
2Absolute number of available rooms for this date. Set this OR deltaQuantity, not both.
Example
5Nightly rate amount (base rate)
Example
450Rate 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
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"}Example
{ "closedOnArrival": false, "closedOnDeparture": false, "currencyCode": "THB", "deltaQuantity": 1, "extraChildRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "extraPaxRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "idempotencyKey": "booking-f4d1c8e5-2b9a:CREATED", "master": true, "maxLengthOfStay": 30, "minLengthOfStay": 2, "quantity": 5, "rate": 450, "singleOccupancyRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }}Example
{ "key": { "date": "2026-01-14", "guestRoomIdentifier": "6f9b4c8d-1e5a-4b3c-9d2e-8a7f0c1b5e43", "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "ratePlanIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51" }, "value": { "closedOnArrival": false, "closedOnDeparture": false, "currencyCode": "THB", "deltaQuantity": 1, "extraChildRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "extraPaxRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" }, "idempotencyKey": "booking-f4d1c8e5-2b9a:CREATED", "master": true, "maxLengthOfStay": 30, "minLengthOfStay": 2, "quantity": 5, "rate": 450, "singleOccupancyRateModifier": { "fixedAmount": { "amount": 1250, "currency": "USD" }, "percent": 0.25, "type": "PERCENTAGE" } }}Responses
Section titled “Responses”Per-day rate changes applied; 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