Hotels

Search bookable hotel rates

Changed on

Search real, bookable hotel inventory.

Every rate type is returned, refundable and non-refundable. Each offer carries refundable and, on a refundable rate, free_cancellation_until.

price is the all-in total the guest pays, in currency (USD unless requested otherwise): the supplier's cost plus 6.4% for Revolut Pay or an EEA-issued card, 8.3% for a card issued elsewhere (markup_rate). expected_cost is the supplier's own figure, there only to be sent back to booking. Keep the chosen offer's session_id and combination_id_v2 — together they identify that exact rate, and booking needs both.

Look-to-book: 1,000 searches are free after every hotel booking, then blocks of 1,000 for $5.00 from prepaid balance.

Searching needs no payment method on file; booking does (402 without one). An account with no payment method gets a daily number of hotel searches.

post/api/v1/hotels/search

Request

  • Base URL: https://letsfg.co/developers/api/v1
  • URL: https://letsfg.co/developers/api/v1/api/v1/hotels/search
  • Auth: API key in header X-API-Key

Request body

city_idinteger required
city_namestring required
check_instring date required
check_outstring date required
adultsinteger
childreninteger
child_agesinteger[]

Required by the supplier to price children.

nationalitystring

Two-letter code. Rates and taxes genuinely differ by nationality.

currencystring

ISO code every price is quoted in.

limitinteger

Example request

{
  "city_id": 148614,
  "city_name": "Warsaw, Poland",
  "check_in": "2026-11-10",
  "check_out": "2026-11-12"
}

Response

Hotels with bookable offers

Changes