Search for hotels and create a hotel booking in Amadeus

Steps

1. Search for hotels near a city using GET /v1/reference-data/locations/hotels/by-city with cityCode (IATA city code) and optional radius, radiusUnit, hotelSource params to get a list of hotelId values.
2. Fetch available rates by calling GET /v3/shopping/hotel-offers with hotelIds (comma-separated), checkInDate, checkOutDate, adults, roomQuantity; each result contains offers[] with rate, room type, and cancellation policy.
3. Confirm current availability and price immediately before booking by calling GET /v3/shopping/hotel-offers/{offerId} — list-level prices are dynamic and may be stale.
4. Create the booking with POST /v2/booking/hotel-orders (the current Hotel Booking v2 resource — the older /v1/booking/hotel-bookings endpoint is a different, deprecated resource with a different payload shape). Set data.type='hotel-order', data.roomAssociations[].hotelOfferId to the confirmed offer id, data.guests[] (tid, title, firstName, lastName, phone, email), and data.payment.paymentCard with card details.
5. On success, read the hotel's own confirmation number from data.hotelBookings[].hotelProviderInformation[].confirmationNumber, and store it alongside the Amadeus order id at data.id.
6. Check data.hotelBookings[].hotelOffer.policies.cancellations and paymentType before booking to know whether the card is charged immediately (guarantee) or a deposit applies.