ImmobiNet
ImmobiNet API Docs - Availability

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: price is the total price of one night for those guests;
  • fixed: price is 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 a fixed rate 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 a fixed rate 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 use GET /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

GET
/api/v1/rate-plans/{ratePlan}/rates
basic

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.

Retrieve the prices of a rate plan, by period › path Parameters

ratePlan
​string · pattern: [0-9A-Za-z_.-]+ · required

Name of a rate plan enabled for the API user (see /api/v1/rate-plans).

Example: www

Retrieve the prices of a rate plan, by period › query Parameters

from
​string · required

First day of the range, YYYY-MM-DD.

Example: 2027-06-01
to
​string · required

Last 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.

Example: 2027-06-30
property_ids
​integer[] · style: form

Only these properties (ids), comma-separated (property_ids=12,15). Together with property_codes at most 50 values.

property_codes
​string[] · style: form

Only the properties with these codes (case-insensitive), comma-separated (property_codes=A1,B2). Together with property_ids at most 50 values.

paging_limit
​integer · min: 1 · max: 50

Limit items returned in response. Must be between 1 and 50

Default: 20
next_cursor
​string | null

Retrieve the prices of a rate plan, by period › Responses

Successful response

​object