Get hotel rates
sabre_hotel_rates_codedThe rate list for one hotel through the agency's reservation access: every bookable rate with room and bed type, the stay total in the hotel's currency (total_after_tax is the amount quoted), what is included (breakfast), the cancellation deadline and penalty in words, deposit or prepayment terms, and the benefits attached to preferred-partner rates (daily breakfast, property credit where offered, upgrade on arrival subject to availability, early check-in / late check-out). hotel_name and chain_code come from the search result and select the partner rates. rooms=2 prices two rooms and the returned rate_key then covers both. Partner rates and their benefit text are returned for adults-only occupancy, so the list is priced adults-only unless children and child_ages are passed. A second call with children and child_ages returns the hotel's family price only when the reply says 'children priced': for the same room and rate plan, the difference from the adults-only total is the hotel's child charge. When the property ignores the children or cannot price them, there is no child price in the system and none can be estimated. Child policy, maximum occupancy and extra-person or extra-bed charges appear only where the rate text states them. A payment link for a stay with children can only be made for the adults, from the adults-only rate key and a rate with free cancellation: the stay is booked as N adults, and after booking the advisor (flybestorg@gmail.com) confirms the children and any changes (extra-person charge or bedding) with the hotel and gets back to them. A non-refundable or prepaid rate is not offered by link for a stay with children; those requests go to flybestorg@gmail.com with hotel, dates, room and rate, number of adults and the children's ages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rooms | No | how many rooms at this property for these dates. Totals cover ALL of them for the whole stay; per_room_total is on each row beside it. adults/children/child_ages then describe EVERY room. | |
| adults | No | ||
| check_in | Yes | YYYY-MM-DD | |
| children | No | number of children, sent together with child_ages of the same length (the call is refused otherwise — Sabre answers children-without-ages with 200 and zero rates, which is indistinguishable from sold out. Omitting children means every price returned is an ADULTS-ONLY price. | |
| currency | No | 3-letter code for the DISPLAY conversion shown beside each rate (default USD). The hotel's OWN currency is always what is quoted and what gets charged — this only changes the ≈ estimate, e.g. CNY for a client who thinks in RMB. Allowed: USD CNY HKD TWD EUR GBP JPY SGD AUD CAD CHF THB KRW. Anything else is REFUSED, because Sabre answers an unknown code with 200 and ZERO rates (measured 2026-09-12) — indistinguishable from sold out. | |
| max_rows | No | rows to return, default 60, up to 400. The cap is ours, not Sabre's, and rows come cheapest-first — so a short answer lost the DEAREST rows. Check `truncated` in the reply before concluding a programme has no suites | |
| check_out | Yes | YYYY-MM-DD | |
| chain_code | Yes | from sabre_hotel_search — drives programme selection | |
| child_ages | No | e.g. [10, 8]. Check occupancy.children_honoured in the result: many properties accept and then ignore children, and the total comes back adults-only. | |
| hotel_code | Yes | Sabre hotel code | |
| hotel_name | Yes | from sabre_hotel_search — drives programme selection | |
| rate_codes | No | override the automatic selection; unloaded codes are dropped rather than silently returning public rates | |
| with_perks | No | fetch the benefit text (breakfast/credit/upgrade) for the cheapest rows — one extra Sabre call each | |
| perks_top_n | No | how many rows per programme (default 5) | |
| room_contains | No | keep only rows whose room/plan text contains this, e.g. "suite" or "villa". Applied BEFORE the row cap, so this is how you reach a room type that prices above the cheap rooms | |
| cheapest_first | No | false sorts dearest first — the other way to surface suites | |
| negotiated_only | No | keep ONLY programme-negotiated rows and drop the public ones. On a property with several plans per room the public half is what pushes suites out of the window | |
| room_occupancies | No | one entry per room, in room order, when the rooms differ. Mutually exclusive with adults/children/child_ages. |