Hotels

Live rates

Live rooms and rate plans for up to 15 hotels. Each room carries its catalogue facts and the cheapest rate per meal plan and free-cancellation option, with the roomId and ratePlanCode for create_booking. Takes about 15 seconds.

get_rates · Read-only · CLI: fortrip rates

Input

hotelIdsinteger[]required

Hotels to price. Each call takes about 15 seconds.1–15 items · each > 0

checkInstringrequired

Check-in date, yyyy-MM-dd.

checkOutstringrequired

Check-out date, yyyy-MM-dd. Stays are 1 to 15 nights.

roomsintegerrequired

Number of rooms.1–8

adultsintegerrequired

Adults per room.1–8

childrenAgesinteger[]

Age of each child per room.≤ 8 items · each 0–17

nationalitystring

Guest nationality as an ISO 3166-1 alpha-2 code, e.g. CN. Some rates are limited to certain nationalities.matches ^[A-Z]{2}$

currency"CNY" | "USD"

Currency to show prices in. Prices are converted at Stripe's exchange rate; the response's fx says how.default "CNY"

bookableOnlyboolean

Keep only rates that are bookable on every night.default true

boardCodes("RO" | "BB" | "HB" | "FB" | "BL" | "BD" | "HBBL" | "HBLD" | "AI")[]

Keep only these meal plans: RO room only, BB breakfast, HB half board, FB full board, AI all inclusive, and so on.≥ 1 items

freeCancellationboolean

Keep only rates that can still be cancelled free of charge right now.

maxRoomsPerHotelinteger

Return the N cheapest rooms per hotel. The MCP tool defaults to 5, the CLI to 10.1–200 · default 5

Output

Returns the Rates result object as structuredContent. Errors are described in the overview.