Rates (/api/v1/rate-plans/{ratePlan}/rates, replaces the SOAP calls getListino and getListinoPersone): the prices of a rate
plan per property, as periods with a price for each number of guests, in euro, with any markup of the channel of the
webservice configuration already applied. What price means depends on the type of the rate plan (type in
/api/v1/rate-plans, rate_plan_type in each item):
per_night:priceis the total price of one night for those guests;fixed:priceis one flat amount for a stay inside that period, whatever the number of nights (rules on the length of stay and on the arrival day are not part of this API). On afixedrate plan only percentage supplements per number of guests are given (the flat amount increased by that percentage); supplements in euro are charged per night, so they cannot be one flat amount and are not given: those numbers of guests show the flat amount without them. A stay that runs across two or more periods of afixedrate plan pays the flat amount of each period it touches: this API does not add them up, so for the price of a specific stay useGET /api/v1/search/available-properties.
A property without a price in the range is not returned, so a page can hold fewer items than
paging_limit (even none): keep following next_cursor until it is null. The range, the filters and the
pagination follow the rules of /api/v1/rate-plans/{ratePlan}/availability.
Retrieve the prices of a rate plan, by period
Returns a paginated list with one item per property that has prices in the range, ordered by property id ascending. Requires the API key scope rates:read.
path Parameters
ratePlan[0-9A-Za-z_.-]+ · requiredName of a rate plan enabled for the API user (see /api/v1/rate-plans).
query Parameters
fromFirst day of the range, YYYY-MM-DD.
toLast day of the range (inclusive), YYYY-MM-DD. The range from from to to, both included, is at most 366 days; to before from returns 400.
property_idsOnly these properties (ids), comma-separated (property_ids=12,15). Together with property_codes at most 50 values.
property_codesOnly the properties with these codes (case-insensitive), comma-separated (property_codes=A1,B2). Together with property_ids at most 50 values.
paging_limitLimit items returned in response. Must be between 1 and 50
next_cursorRetrieve the prices of a rate plan, by period › Responses
Successful response

