---
title: "Hotels"
description: "The hotel funnel, same shape as flights: `createHotelSearch`, `getHotelSearchResults` for ranked hotels, `getHotel` for static detail, `getHotelRates` for bookable rooms and rates (cheapest first, with board and refundability), `getHotelRateBookingLink` for the wego.com checkout URL."
---

> Documentation Index
> Fetch the complete documentation index at: https://agents.wego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hotels

The hotel funnel, same shape as flights: `createHotelSearch`, `getHotelSearchResults` for ranked hotels, `getHotel` for static detail, `getHotelRates` for bookable rooms and rates (cheapest first, with board and refundability), `getHotelRateBookingLink` for the wego.com checkout URL.

## Operations

| Verb | Operation | Carries onward |
|---|---|---|
| `POST` | [Create a hotel search](/api/hotels/create-hotel-search) · `/v1/hotels/searches` | `searchId` |
| `GET` | [Read hotel search results](/api/hotels/get-hotel-search-results) · `/v1/hotels/searches/{searchId}/results` | `hotelId` |
| `GET` | [Build a hotel booking link](/api/hotels/get-hotel-rate-booking-link) · `/v1/hotels/{hotelId}/rates/{rateId}/booking-link` | `wego.com URL` |
| `GET` | [Build a durable wego.com hotel search link](/api/hotels/get-hotel-search-link) · `/v1/hotels/search-link` | `wego.com URL` |
| `GET` | [List a hotel's rooms & rates](/api/hotels/get-hotel-rates) · `/v1/hotels/{hotelId}/rates` | `rateId` |
| `GET` | [Search a hotel's guest reviews](/api/hotels/get-hotel-reviews) · `/v1/hotels/{hotelId}/reviews` | `terminal` |
| `GET` | [Get hotel detail](/api/hotels/get-hotel) · `/v1/hotels/{hotelId}` | `terminal` |

Source: https://agents.wego.com/api/hotels/index.mdx