Get all property rates by date range
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/master-rate/rates/dates';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"endDate":"2020-12-31","startDate":"2020-12-24"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/master-rate/rates/dates \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "endDate": "2020-12-31", "startDate": "2020-12-24" }'Retrieve all daily rates across every master rate at a property for a specified date range.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Property identifier (managing entity UUID) to fetch rates for
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Start and end dates defining the inclusive date range for which all property rates should be retrieved
object
Retrieve data range ending with and including this end date
Example
2020-12-31Retrieve data range starting with and including this start date
Example
2020-12-24Example
{ "endDate": "2020-12-31", "startDate": "2020-12-24"}Responses
Section titled “Responses”All daily rates across every master rate at the property for the requested date range
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