latestOpenAPI 3.1.02026-08-21211181.8 KB

e5d7af502419

Hotels

Get hotel detail

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

get/v1/hotels/{hotelId}

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.

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.