Hotels

Get hotel detail

Changed on

Returns static hotel detail (name, stars, address, images, amenities, reviews). Use ?view=detail for the richer UI projection.

get/v1/hotels/{hotelId}

Request

  • Base URL
    https://api.wego.com
  • Auth
    • OAuth 2
      Authorization codehttps://auth.wego.com/user-auth/v2/users/oauth/authorize
      Token URLhttps://auth.wego.com/user-auth/v2/users/oauth/token
    • or HTTP bearer
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

hotelIdinteger required

The hotel's numeric id (a positive integer), as carried by hotel search results (results[].hotelId) and embedded in a rate id.

Query parameters

localestring

Response language tag (e.g. en, ar). Defaults to en.

view'default' | 'detail'

Response projection. default: the agent hotel detail. detail: the richer UI projection (categorized images, review highlights, badges). Defaults to default.

Response

Hotel detail (agent default) or the detail projection.

hotelIdnumber required

The hotel's numeric id.

namestring required

Hotel display name.

pageUrlstring required

The hotel's page on wego.com. It is not tied to a search, so it keeps working after this search expires. Give it to a traveller who wants to look at the hotel, and use it in anything that is saved or sent on. It opens with no dates set.

starnumber

Star rating (1-5), when classified.

propertyTypestring

Property type, e.g. Hotel, Apartment.

brandNamestring

Brand name, when the hotel belongs to one.

chainNamestring

Parent chain name, when known.

descriptionstring

Editorial description of the hotel.

amenitiesstring[]

Hotel-level amenity names.

imagesstring[]

Hotel image URLs.

distanceToCityCentrenumber

Kilometres from the city's place-record coordinate (the point GET /v1/places reports for the city). Where a city record covers an island, a city-state or a whole administrative area, that point can sit far from the commercial centre. For a specific landmark, compute distance from location.lat/lng. Present when upstream reports it.

distanceToNearestAirportnumber

Distance to the nearest airport, as the upstream reports it (unit not normalized here). Absent when upstream omits it.

Changes

    • info

      added the required property to the response with the status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status