Get Rates
get_ratesGet the price level of each apartment for a whole month plus that month's booking rules.
Use when the guest has no exact dates yet ("what does a week in July cost?", "when is it cheapest?"). For each apartment it returns the lowest total price of a real reference stay in that month (usually 7 nights, incl. final cleaning and tourist tax) and the arrival days / minimum stay / closures of the month. Not for exact prices on specific dates — use check_availability for that. Visual version: render_rates_card with the same arguments. Behaviour: read-only, live from the booking system (about 1-2 s, cached 5 min). Returns text plus structuredContent (apartments, periods, weeks, perks, offers).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| month | No | Month as '2027-07', 'July', 'Juli 2027'; empty = next month | |
| adults | No | Adults sharing one apartment (1-5) | |
| guests | No | Deprecated alias of adults (clients before 2.2.0); 0 = unused | |
| children | No | Ages of ALL children 0-17, comma-separated, e.g. '8,15'; empty if none. Ages change price and tourist tax (charged from age 17). | |
| language | No | Answer language: 'de' (default) or 'en' — use the language of the conversation. Text and card are always in the same language. | de |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| month | No | YYYY-MM | |
| perks | No | ||
| weeks | No | Searched reference stays with all prices | |
| adults | No | ||
| offers | No | ||
| status | No | ok, closed, fully_booked or not_released | |
| periods | No | Booking rules: from, to, closed, min_nights, arrival_weekdays | |
| language | No | ||
| apartments | No | Per apartment: nr, name, lowest total EUR, nights, check_in/check_out of that reference stay | |
| child_ages | No |